Integration Process

For third‑party applications, SDH recommends the following guidelines to ensure a correct integration with the SDH service:

• Once the invoice record is generated in the third‑party application, it must be automatically delivered to the SDH service.

• The application must wait for the SDH service response, which will return the corresponding result for that invoice:

  • If the invoice is accepted by SDH, the response will include the QR code to be printed on the invoice.
  • If the invoice is rejected by SDH due to a validation error, the invoice must be corrected and sent again to the SDH service with the corrected data.
    When SDH returns validation errors, the invoice has not been processed by the tax administration service.

• Once a correct result is received, the third‑party application may continue with the next invoice record, leaving any invoice with validation errors pending for later submission.

• From some part of the third‑party application, it must be possible to query the invoice status in the SDH service. This query will return both the status of the record in the SDH service, and the status of the invoice in the corresponding tax administration service. The latter will only be available if the invoice has already been delivered by SDH to the administration service.

• When an invoice is cancelled by the third‑party application, it must notify the SDH service immediately and wait for its response.

Continue reviewing the sections on Invoice Creation and Invoice Cancellation.