Billing response: Use cases
The purpose of sending a billing response is to inform the seller about the progress of the invoice processing in the buyer's system.
A billing response is supposed to be issued within three working days after receiving an invoice. In return, depending on the use case, the seller is supposed to issue a new business document, supply additional information, or take no further action.
How the seller handles the action is out of scope and must be managed externally.
The following section outlines the most common use cases in which a billing response is issued. Each example is a complete request body for POST /transactions/submit-billing-response. In all of them, the buyer Example Buyer hf. responds to invoice INV-2026-0123 from the seller Example Supplier ehf. The structure is described in Billing response elements.
Invoice is being processed
The buyer has received the invoice but is unable to provide a definite response before the maximum response time expires.
The maximum response time is three working days following the receipt of the invoice. However, the seller should not contact the buyer until another three working days have passed.
In this case, the buyer issues a billing response with the InProcess status within three days of receiving the invoice.
The buyer then needs to issue another billing response when the invoice has finished processing.
This does not cover the billing responses with the Other status.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0101",
"issueDate": "2026-10-02T09:00:00Z",
"status": "InProcess",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" }
}
}Invoice is being processed with additional reference data
The buyer has received the invoice and wants to provide additional information to the seller without prompting any other action from the seller.
For example, this can be the invoice receipt date or the invoice reference in the buyer's system.
The billing response status is InProcess.
When providing additional information in the billing response metadata, the date when the invoice was received is specified as effectiveDate.
For information such as the internal invoice reference identifier, use details in a reasons entry with the reason NoIssue.
In details, the type property describes the information shared, while the value property contains the information itself.
The expected course of action on the seller's side is defined in the actions array, where action is NoActionRequired. actionDescription can add details about the action.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0102",
"issueDate": "2026-10-02T09:00:00Z",
"status": "InProcess",
"effectiveDate": "2026-10-01T00:00:00Z",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "NoIssue",
"details": [
{ "type": "Buyer process reference", "value": "AP-26-48817" }
]
}
],
"actions": [
{ "action": "NoActionRequired" }
]
}
}Invoice is being processed but is put on hold
The buyer has received the invoice but could not complete the processing because of an issue with the invoice or the business process.
This can occur in cases when the buyer was unable to validate the invoice reference number or when the goods have not yet been delivered.
The buyer then lets the seller know that the processing will be continued after updating the invoice details or after the shipment arrives.
In the billing response metadata, the date when the invoice processing will resume is specified as effectiveDate.
The billing response status is InProcess, and the additional information regarding the status is given in reasonDescription in a reasons entry.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0103",
"issueDate": "2026-10-05T09:00:00Z",
"status": "InProcess",
"effectiveDate": "2026-10-19T00:00:00Z",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "DeliveryIssues",
"reasonDescription": "We are awaiting the delivery of the items."
}
]
}
}Invoice is accepted
The buyer has accepted the invoice and the seller can expect that the invoice will be paid on time.
No additional information needs to be provided and the billing response status is Accepted.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0104",
"issueDate": "2026-10-03T09:00:00Z",
"status": "Accepted",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" }
}
}Invoice is rejected
The buyer has rejected the invoice and provided only a textual description of the issue, for example, PO reference is missing.
This means that the buyer has not requested any action from the seller. The reason is given in a reasons entry, with the description in reasonDescription.
To get any further information or resolve the issue, the seller can communicate with the buyer outside of the application.
The billing response has the Rejected status.
When you reject an invoice from a Croatian supplier, rejectionReasonCode is also required, see Croatia: rejection reason code.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0105",
"issueDate": "2026-10-02T09:00:00Z",
"status": "Rejected",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "ReferencesIncorrect",
"reasonDescription": "The purchase order reference is missing."
}
]
}
}Invoice is rejected and a reissue is requested
The buyer has rejected the invoice and requires that the matter is resolved by issuing the invoice again after corrections are made.
For example, an invoice can be rejected because it does not state the relevant purchase order.
The buyer might not need a credit note if the incorrect invoice has not been booked. In that case, the buyer indicates that the billing response status is Rejected.
The reason for the status is given in reasons (ReferencesIncorrect).
The required action is given in the actions array (IssueNewInvoice).
Optionally, the buyer can describe the problem in more detail in actionDescription.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0106",
"issueDate": "2026-10-02T09:00:00Z",
"status": "Rejected",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{ "reason": "ReferencesIncorrect" }
],
"actions": [
{
"action": "IssueNewInvoice",
"actionDescription": "Please issue a new invoice with our purchase order reference PO-4711."
}
]
}
}Invoice is rejected and a replacement is requested
The buyer has rejected the invoice that has already been booked in the buyer's system.
The buyer then requests a credit note for the incorrect invoice and a new invoice.
The billing response status is then set to Rejected, with the explanation in reasons.
For example, if the invoice is rejected because a reference to the purchase order is missing, reason has the value ReferencesIncorrect.
The actions expected from the seller are defined in the actions array:
- When requesting a credit note, the first entry has the
actionCreditFully. - The second entry has the
actionIssueNewInvoice. - Any further clarifications (
actionDescription) are optional.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0107",
"issueDate": "2026-10-02T09:00:00Z",
"status": "Rejected",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{ "reason": "ReferencesIncorrect" }
],
"actions": [
{ "action": "CreditFully" },
{ "action": "IssueNewInvoice" }
]
}
}Invoice is conditionally accepted
The buyer can conditionally accept the invoice while proposing new terms.
For example, this can happen if the invoice due date is different from the one previously negotiated between the buyer and the seller.
The status property is set to ConditionallyAccepted, and the reasons entry has the reason PaymentTermsIncorrect.
The buyer can also add more details in reasonDescription.
The updated payment terms are suggested using details in the same reasons entry:
typerefers to the element, for exampleBT-9orInvoice due date, whilevaluecontains the new value of the element. In the example,valueis the new payment date.
In case of disagreement with the new payment terms, the seller needs to reach the buyer outside of the application.
Otherwise, no action is necessary.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0108",
"issueDate": "2026-10-02T09:00:00Z",
"status": "ConditionallyAccepted",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "PaymentTermsIncorrect",
"reasonDescription": "The agreed payment term is 45 days.",
"details": [
{ "type": "BT-9 (Due date)", "value": "2026-11-15" }
]
}
]
}
}Invoice is under query due to missing or incorrect information
The buyer requests additional information from the seller to be able to continue processing the invoice.
The billing response status is UnderQuery and the buyer provides the date on which the invoice processing was put on hold (effectiveDate in the billing response metadata).
This facilitates handling any delays in payment that might occur due to longer processing.
For example, if the invoice is missing a purchase order reference, the reasons entry has the reason ReferencesIncorrect.
The clarification is given in details in the same entry.
The buyer indicates the missing element in the type property, for example, BT-13 or Purchase order reference, and suggests the correct value as the value property, for example, PO-4711.
Given that the seller needs to communicate the missing information to the buyer, the action in the actions array is ProvideInformation.
The buyer can add any other information in actionDescription.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0109",
"issueDate": "2026-10-06T09:00:00Z",
"status": "UnderQuery",
"effectiveDate": "2026-10-05T00:00:00Z",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "ReferencesIncorrect",
"details": [
{ "type": "BT-13 (Purchase order reference)", "value": "PO-4711" }
]
}
],
"actions": [
{
"action": "ProvideInformation",
"actionDescription": "Please confirm the purchase order reference."
}
]
}
}Invoice is under query due to incorrect details and a partial credit note is requested
The buyer has put the invoice processing on hold until the information in the invoice is corrected and a partial refund is issued.
For example, this can occur if the quantity stated on the invoice and the quantity delivered do not match.
The buyer resumes the processing after receiving a partial credit note.
The status property is set to UnderQuery.
The reasons entry has the reason DeliveryIssues, and a more detailed description is given in reasonDescription.
Finally, the buyer defines the action that the seller needs to take in the actions array:
- Here, the seller is supposed to issue a credit note that covers a part of the total costs.
- The
actionis thenCreditPartially.
The buyer also has the option of providing more details, such as contact information, in actionDescription.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0110",
"issueDate": "2026-10-06T09:00:00Z",
"status": "UnderQuery",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" },
"reasons": [
{
"reason": "DeliveryIssues",
"reasonDescription": "For item VH5Y11LA7P (line 3 of the invoice) the ordered and invoiced quantity was 6 units. We have received only 5 units."
}
],
"actions": [
{
"action": "CreditPartially",
"actionDescription": "Please issue a credit note for the missing unit."
}
]
}
}Invoice payment is initiated
The buyer notifies the seller that the invoice has been paid.
The billing response status is Paid.
The buyer can also indicate the date on which the payment was made using the effectiveDate property in the billing response metadata.
{
"messageHandling": {
"receiverIdentifier": "0196:6511230889",
"fallbackEmailAddress": "[email protected]"
},
"invoiceResponse": {
"responseNo": "RESP-2026-0111",
"issueDate": "2026-10-20T09:00:00Z",
"status": "Paid",
"effectiveDate": "2026-10-19T00:00:00Z",
"sender": { "name": "Example Buyer hf.", "identifier": "0196:5504030000" },
"receiver": { "name": "Example Supplier ehf.", "identifier": "0196:6511230889" },
"documentReference": { "documentNo": "INV-2026-0123", "documentType": "Invoice", "issueDate": "2026-10-01T00:00:00Z" }
}
}Updated 4 days ago