Overview
Document rejection is a way to quickly notify the issuer that that there are some problems with the document they have issued so that correction can be done as soon as possible. Rejection is allowed for recipient of the document only within limited time period since submission of the document on the eInvoicing system. This time limit is specific to document type and is returned by calling Get Document Type API and checking workflow parameters.
If allowed rejection time since issuance has passed but the document is still considered incorrect, receivers need to notify issuers and they need to revert previously issued incorrect invoice trough submission of a credit note for example.
Rejection period is configurable value, that is controlled by ETA and this is configured according to the law, please refer to the law for more information.
Rejection action for any document can happen only once.
Note! when you are logged in as intermediary, permissions that are granted by the taxpayer will be applied on your profile and this will control the functionalities that you'll be able to executed on behalf of the taxpayer you are representing.
Signature
API is REST based API that receives the document ID through the URL parameter and state to be changed in request body.
Signature:
PUT /api/v1.0/documents/state/{UUID}/state
Inputs
This API accepts standard eInvoicing API header parameters for authenticated call.
| URL parameter | Type | Description | Value example |
|---|---|---|---|
| uuid | String | Unique ID of existing document | F9D425P6DS7D8IU |
Body of the request contains a single object that contains these fields:
| Input parameter | Type | Description | Value example |
|---|---|---|---|
| status | String | Desired status for the document. Must be rejected to reject received document. |
rejected |
| reason | String | Reason for rejecting the document. | Received incorrect invoice from the seller |
Outputs
Successful Response
On a successful submission API returns 200 status code.
Error Response
Error situations are reported back by this API through the standard error response.
Additional specialized error messages can be returned as a result of validation of state of the document and caller:
| HTTP Status Code | Error Code | Description |
|---|---|---|
| 400 | OperationPeriodOver | Returned when user is trying to reject document when the limit of rejection has already run out. |
| 400 | IncorrectState | Returned when caller is trying to reject the document that is not in state valid. State transition in this case is not allowed. |
| 400 | ActiveReferencingDocuments | Returned when caller is trying to reject the document that is being referenced by other documents, e.g., credit note referencing invoice that is correcting the problem already. If rejection is still required, the action to take is to reject first the referencing document and only then this one. |
| 400 | TryingToRejectFreezedDocument | Returned when caller is trying to reject the document that is being marked as Freezed |
| 403 | Forbidden | Returned when valid taxpayer system is trying to perform operation on a document not received by them. |
| 403 | Forbidden | Returned when caller of the endpoint is trying to perform operation on a document while caller profile has ‘B2B Deny ERP Cancellation/Rejection’ tag assigned to it by ETA Admin. |
Additional considerations
No additional considerations.