Overview
Decline rejection is a way of taxpayer “issuer” to object the rejection that is done by the taxpayer “recipient” of the document. Ideally when rejection is done by the taxpayer “recipient” of the document and taxpayer “issuer” of the document is notified, then issuer of the document can do one one of two things: - do nothing and this means he is accepting the rejection of the document, in this case document state will remain as rejected - Decline the rejection of the document, in this case document state will be marked as valid.
Decline rejection can be done only once on a specific document and executed only within limited time period since rejection of the document on the eInvoicing system. after This time limit is specific to document type and is returned by calling Get Document Type API and checking workflow parameters.
Deline rejection period is configurable value, that is controlled by ETA & this is configured according to the law, please refer to the law for more information.
If decline rejection time has passed, taxpayers will not be able to decline rejection anymore, and the docment will be marked as rejected on the system.
Note! when you 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}/decline/rejection
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 |
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 decline rejected document when the limit of decline the rejection has already run out. |
| 400 | IncorrectState | Returned when caller is trying to decline the rejected document that might already be rejected or invalid. State transition in this case is not allowed. |
| 403 | Forbidden | Returned when valid taxpayer system is trying to perform operation on a document not issued 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.