Turkey status codes and application responses
Status codes, application responses, and transaction completion handling for e-Fatura and e-Arşiv transactions.
Response code categories
e-Fatura SCI Cloud status codes:
| SCI Status Code | Event Code | Description | SCI Response Code | Action |
|---|---|---|---|---|
| 100 | document.received | Document received by Sovos | IP | NOA |
| 102 | document.validated | Document sent to Sovos Cloud | IP | NOA |
| 200 | document.authorized | Document sent to GIB (codes 1000, 1100, 1200, 1210, 1220) | IP | NOA |
| 203 | document.acceptedByCounterparty | Document accepted by recipient (code 1300) | AP | NOA |
| 209 | workflow completed | Workflow completed successfully | AP | NOA |
| 400 | document.rejected | Document rejected by GIB (code 1195) | RE | NIN |
| 401 | document error | Error processing document | RE | NIN |
| 405 | document.rejectedByCounterparty | Document rejected by recipient (codes 1215, 1230) | RE | NIN |
e-Arşiv SCI Cloud status codes:
| SCI Status Code | Event Code | Description | SCI Response Code | Action |
|---|---|---|---|---|
| 100 | document.received | Document received by Sovos | IP | NOA |
| 209 | workflow completed | Workflow completed successfully | AP | NOA |
| 401 | document error | Error processing document | RE | NIN |
SCI Response codes:
| Code | Description |
|---|---|
| IP | In Progress |
| AP | Approved/Accepted |
| RE | Rejected |
Action codes:
| Code | Description |
|---|---|
| NOA | No action required |
| NIN | Request to reissue a corrected new invoice or fix the error and resend the document |
GIB status codes (referenced in event codes):
| Code | Description |
|---|---|
| 1000 | Document queued for processing |
| 1100 | Document validated by GIB |
| 1195 | Document rejected by GIB |
| 1200 | Document sent to recipient |
| 1210 | Document delivered to recipient system |
| 1215 | Document rejected by recipient system |
| 1220 | Document awaiting recipient response |
| 1230 | Document rejected by counterparty |
| 1300 | Document accepted by counterparty |
GIB application response codes:
| Code | Description |
|---|---|
| KABUL | Invoice accepted by recipient |
| RED | Invoice rejected by recipient |
Response examples
- Success response
-
{ "documentId": "550e8400-e29b-41d4-a716-446655440000", "status": "CLEARED", "gibUuid": "GIB-assigned-UUID", "gibInvoiceNumber": "GIB2025000000001", "timestamp": "2025-01-15T10:35:00Z", "details": { "clearanceTime": "2025-01-15T10:34:55Z" } } - Rejection response
-
{ "documentId": "550e8400-e29b-41d4-a716-446655440000", "status": "FAILED", "timestamp": "2025-01-15T10:35:00Z", "errors": [ { "code": "1106", "message": "Invalid tax calculation: VAT amount does not match taxable base and rate", "field": "TaxTotal/TaxSubtotal/TaxAmount" } ] } - Application response (Accepted)
-
{ "documentId": "550e8400-e29b-41d4-a716-446655440000", "status": "ACCEPTED", "timestamp": "2025-01-20T14:22:00Z", "applicationResponse": { "responseCode": "KABUL", "responseDate": "2025-01-20T14:21:30Z", "responderId": "0987654321" } }
Handling transaction completion
- Polling frequency
-
- Initial poll
-
Immediately after transmission
- Subsequent polls
-
Every 30 seconds for first five minutes
- Extended polling
-
Every five minutes until completion
- Maximum polling duration
-
24 hours
- Completion indicators
-
- Completion
-
When the status is CLEARED, DELIVERED, ACCEPTED, or REJECTED
- Failure
-
When the status is FAILED, this indicates terminal failure
- In progress
-
When the status is PROCESSING or SUBMITTED
