Key Parameters

During the e-invoicing submission process, if there is a network failure while you are submitting an invoice, it may be accepted into Vertex e-Invoicing, but you may not receive a confirmation message. Instead, you could receive an error. If you try to resubmit the invoice, you will not be able to retrieve the unique identifier that is associated with the submission.

To prevent submitting duplicate copies of the invoice, supply a key parameter. You can create a new Globally Unique Identifier (GUID) for each invoice that you transmit and apply that GUID in the Idempotency-Key HTTP header each time you retry the request. When the key parameter is supplied, the server enforces uniqueness constraints on the input value.