--- updatedAt: 2026-09-13T21:03:51.000Z agentTools: projectIndex: https://ae.docs.digitax.tech/llms.txt --- # Acknowledge a UAE Received Invoice Marks a received invoice as acknowledged by the business. This is a business-level record only — it does not affect the Peppol MLS, which is sent automatically and immediately on receipt. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "DigiTax UAE API Endpoints", "description": "DigiTax UAE Public API — Peppol PINT-AE compliant e-invoicing.", "version": "3", "termsOfService": "https://digitax.tech/page/terms", "contact": { "name": "DigiTax", "url": "https://digitax.tech", "email": "support@namiri.tech" }, "license": { "name": "Apache 2.0" } }, "servers": [ { "url": "https://api.digitax.tech/ae/v1", "description": "API" } ], "paths": { "/received-invoices/{received_invoice_id}/acknowledge": { "post": { "tags": [ "Received Invoices" ], "summary": "Acknowledge a UAE Received Invoice", "description": "Marks a received invoice as acknowledged by the business. This is a business-level record only — it does not affect the Peppol MLS, which is sent automatically and immediately on receipt.", "security": [ { "apiKeyAuth": [] } ], "parameters": [ { "in": "path", "name": "received_invoice_id", "required": true, "schema": { "type": "string", "description": "Received invoice ID on DigiTax", "example": "receivedinvoice_01KMFSMEYVCDV0150T6P4WECVR" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReceivedInvoice" } } } }, "default": { "$ref": "#/components/responses/Error" } } } } }, "components": { "schemas": { "Address": { "type": "object", "description": "Postal address", "required": [ "street_name", "city_name", "country_subentity", "country_code" ], "properties": { "street_name": { "type": "string", "description": "The main address line (street name, building number)", "example": "Sheikh Zayed Road, Tower 1" }, "additional_street_name": { "type": "string", "description": "An additional address line", "example": "Floor 22" }, "city_name": { "type": "string", "description": "The city of the address", "example": "Dubai" }, "postal_zone": { "type": "string", "description": "The postal zone or postcode", "example": "00000" }, "country_subentity": { "type": "string", "description": "The country subdivision. When `country_code` is `AE` this is the emirate — see `GET /resources/ae-country-subentities` for available values. Free text for any other country.", "example": "DXB" }, "country_code": { "type": "string", "description": "The ISO 3166-1 alpha-2 country code. See `GET /resources/countries` for available values.", "example": "AE" }, "address_line": { "type": "string", "description": "A free-form address line for additional details", "example": "Near Dubai Mall" } } }, "PartyLegalEntity": { "type": "object", "description": "A party's legal entity — only `registration_name` is required. The rest are only meaningful (and only format-checked) for a UAE-addressed party; a foreign party isn't expected to hold a UAE trade license.", "required": [ "registration_name" ], "properties": { "registration_name": { "type": "string", "description": "The full legal name of the entity as registered with the issuing authority", "example": "Acme Trading LLC" }, "registration_number": { "type": "string", "description": "The legal registration number, such as a trade licence or commercial registration number. Required for a UAE-addressed party.", "example": "TL-12345678" }, "registration_scheme": { "type": "string", "description": "The ISO 6523 ICD code identifying the registration number scheme. Required for a UAE-addressed party. See `GET /resources/international-code-designator-schemes` for available values.", "example": "0235" }, "issuing_authority_code": { "type": "string", "description": "The registration type code. Required for a UAE-addressed party, and restricted to one of `TL`, `CL`, `EID`, `PAS`, `CD` for one — see `GET /resources/legal-registration-types`. Free text for a non-UAE party.", "example": "TL" }, "issuing_authority_name": { "type": "string", "description": "The issuing authority name. For a UAE-addressed party, required when `issuing_authority_code` is `TL`; when `issuing_authority_code` is `PAS`, this must be a valid ISO 3166-1 alpha-2 country code.", "example": "Department of Economic Development" } } }, "ItemProperty": { "type": "object", "description": "An additional item attribute as a name/value pair", "required": [ "name", "value" ], "properties": { "name": { "type": "string", "description": "The name of the item attribute", "example": "Colour" }, "value": { "type": "string", "description": "The value of the item attribute", "example": "Silver" } } }, "OrderReference": { "type": "object", "description": "A reference to a purchase and/or sales order", "properties": { "purchase_order_id": { "type": "string", "description": "An identifier of a referenced purchase order, issued by the Buyer", "example": "PO-2024-00123" }, "sales_order_id": { "type": "string", "description": "An identifier of a referenced sales order, issued by the Seller", "example": "SO-2024-00456" } } }, "DocumentReference": { "type": "object", "description": "A reference to another document (e.g. despatch advice, receipt advice, contract)", "required": [ "id" ], "properties": { "id": { "type": "string", "description": "The identifier of the referenced document", "example": "DA-2024-001" }, "document_type_code": { "type": "string", "description": "The UNCL1001 document type code of the referenced document", "example": "916" }, "document_description": { "type": "string", "description": "A human-readable description of the referenced document", "example": "Despatch Advice" }, "issue_date": { "type": "string", "description": "The issue date of the referenced document (YYYY-MM-DD)", "example": "2026-07-14" } } }, "InvoicePeriod": { "type": "object", "description": "The period to which the invoice relates", "properties": { "start_date": { "type": "string", "description": "The start date of the invoice period (YYYY-MM-DD)", "example": "2026-07-14" }, "end_date": { "type": "string", "description": "The end date of the invoice period (YYYY-MM-DD)", "example": "2026-08-13" }, "billing_frequency_code": { "type": "string", "description": "The billing frequency code. See `GET /resources/billing-frequencies` for available values.", "example": "MTH" } } }, "InvoiceDelivery": { "type": "object", "description": "Delivery information for the items in the invoice. When `transaction_types` includes `EXPORTS`, `delivery` is required and `delivery_address.country_code` must not be `AE`.", "properties": { "actual_delivery_date": { "type": "string", "description": "The actual delivery date (YYYY-MM-DD)", "example": "2026-07-14" }, "delivery_location_id": { "type": "string", "description": "The identifier of the delivery location", "example": "LOC-JEBEL-ALI-001" }, "delivery_location_scheme_id": { "type": "string", "description": "The scheme identifier for the delivery location ID. See `GET /resources/delivery-location-schemes` for available values.", "example": "0088" }, "delivery_address": { "$ref": "#/components/schemas/Address" }, "delivery_party_name": { "type": "string", "description": "The name of the party receiving the delivery", "example": "Global Imports FZE - Warehouse" }, "delivery_terms_id": { "type": "string", "description": "The Incoterms delivery terms identifier. Required when `transaction_types` includes `EXPORTS` or `SUPPLY_THROUGH_ECOMMERCE`.", "example": "DAP" } } }, "InvoiceAllowanceCharge": { "type": "object", "description": "An allowance or charge at document level", "required": [ "charge_indicator", "amount", "reason_code", "reason", "tax_category_code", "tax_rate" ], "properties": { "charge_indicator": { "type": "boolean", "description": "If true, this is a charge; if false, it is an allowance", "example": false }, "amount": { "type": "number", "format": "double", "description": "The monetary amount of the allowance or charge", "example": 50 }, "base_amount": { "type": "number", "format": "double", "description": "The base amount on which the allowance or charge percentage is calculated", "example": 1000 }, "multiplier_rate": { "type": "number", "format": "double", "description": "The rate(between 0 to 1) used to calculate the allowance/charge amount", "example": 0.05, "minimum": 0, "maximum": 1 }, "reason_code": { "type": "string", "description": "The coded reason for the allowance or charge. See `GET /resources/allowance-reasons` (for allowances) or `GET /resources/charge-reasons` (for charges) for available values.", "example": "95" }, "reason": { "type": "string", "description": "The textual reason for the allowance or charge", "example": "Volume discount" }, "tax_category_code": { "type": "string", "description": "The VAT category code for this allowance/charge. It is required for document-level allowances/charges. See `GET /resources/tax-categories` for available values.", "example": "E" }, "tax_rate": { "type": "number", "format": "double", "description": "The VAT rate applicable to this allowance/charge", "example": 0, "minimum": 0, "maximum": 1 }, "tax_exemption_reason_code": { "type": "string", "description": "The coded reason for VAT exemption if the allowance/charge is tax exempt. See `GET /resources/tax-exemption-reasons` for available values.", "example": "DL8.46.1" }, "tax_exemption_reason": { "type": "string", "description": "The textual reason for VAT exemption if the allowance/charge is tax exempt", "example": "Certain financial services" } } }, "InvoiceItemAllowanceCharge": { "type": "object", "description": "An allowance or charge at invoice item level", "required": [ "charge_indicator", "amount", "reason_code", "reason" ], "properties": { "charge_indicator": { "type": "boolean", "description": "If true, this is a charge; if false, it is an allowance", "example": false }, "amount": { "type": "number", "format": "double", "description": "The monetary amount of the allowance or charge", "example": 50 }, "base_amount": { "type": "number", "format": "double", "description": "The base amount on which the allowance or charge percentage is calculated", "example": 1000 }, "multiplier_rate": { "type": "number", "format": "double", "description": "The rate(between 0 to 1) used to calculate the allowance/charge amount", "example": 0.05, "minimum": 0, "maximum": 1 }, "reason_code": { "type": "string", "description": "The coded reason for the allowance or charge. See `GET /resources/allowance-reasons` (for allowances) or `GET /resources/charge-reasons` (for charges) for available values.", "example": "95" }, "reason": { "type": "string", "description": "The textual reason for the allowance or charge", "example": "Volume discount" } } }, "TaxBreakdown": { "type": "object", "description": "A breakdown of VAT by category", "required": [ "tax_category_code", "taxable_amount", "tax_amount", "currency", "tax_rate" ], "properties": { "id": { "type": "string", "description": "The unique DigiTax identifier for this tax breakdown record", "example": "taxbreakdown_01KMFHQG90HC0H5CA6CZ0A93VC" }, "tax_category_code": { "type": "string", "description": "The VAT category code", "example": "S" }, "taxable_amount": { "type": "number", "format": "double", "description": "The net amount subject to this VAT category", "example": 10000 }, "tax_amount": { "type": "number", "format": "double", "description": "The VAT amount for this category", "example": 500 }, "currency": { "type": "string", "description": "The currency code for the tax amounts", "example": "AED" }, "tax_rate": { "type": "number", "format": "double", "description": "The VAT rate(between 0 and 1)", "example": 0.05, "minimum": 0, "maximum": 1 } } }, "ReceivedParty": { "type": "object", "description": "A party embedded in a received invoice, extracted from the incoming Peppol document", "properties": { "tax_registration_number": { "type": "string", "description": "The UAE Tax Registration Number (TRN) of the party", "example": "100987654300003" }, "party_name": { "type": "string", "description": "The trading name of the party", "example": "Global Imports Trading" }, "legal_entity": { "$ref": "#/components/schemas/PartyLegalEntity" }, "address": { "$ref": "#/components/schemas/Address" }, "contact_name": { "type": "string", "description": "The name of the contact person", "example": "Sara Mohammed" }, "contact_phone": { "type": "string", "description": "The contact phone number", "example": "+971509876543" }, "contact_email": { "type": "string", "format": "email", "description": "The contact email address", "example": "sara@global-imports.ae" }, "peppol_id": { "type": "string", "description": "The party's Peppol participant identifier", "example": "1234567890123" }, "peppol_id_scheme": { "type": "string", "description": "The Peppol EAS code for `peppol_id`", "example": "0088" } } }, "ReceivedPaymentMeans": { "type": "object", "description": "Payment means embedded in a received invoice", "properties": { "payment_means_code": { "type": "string", "description": "The UNCL4461 code identifying the payment means", "example": "30" }, "payment_means_code_name": { "type": "string", "description": "The name of the payment means code", "example": "Credit transfer" }, "payment_id": { "type": "string", "description": "The payment reference or remittance information", "example": "PAY-REF-2024-001" }, "payee_account_id": { "type": "string", "description": "The payee's bank account number (IBAN)", "example": "AE070331234567890123456" }, "payee_account_name": { "type": "string", "description": "The name of the payee's bank account", "example": "Acme Trading LLC - Main Account" }, "payee_financial_institution_bic": { "type": "string", "description": "The BIC/SWIFT code of the payee's bank", "example": "ADCBAEAA" }, "card_primary_account_number": { "type": "string", "description": "The last few digits of the card used for payment", "example": "****1234" }, "card_network_id": { "type": "string", "description": "The network identifier of the payment card", "example": "VISA" }, "card_holder_name": { "type": "string", "description": "The name of the card holder", "example": "Ahmed Al-Rashid" }, "payment_mandate_id": { "type": "string", "description": "The mandate reference for direct debit", "example": "MANDATE-2024-001" } } }, "ReceivedInvoiceLine": { "type": "object", "description": "A line item embedded in a received invoice", "properties": { "line_id": { "type": "integer", "description": "The sequential line identifier within the invoice", "example": 1 }, "note": { "type": "string", "description": "A free-text note on the invoice line", "example": "Special handling required" }, "name": { "type": "string", "description": "The item name", "example": "Industrial Pump Model X-500" }, "description": { "type": "string", "description": "A description of the item", "example": "High-pressure centrifugal pump for industrial fluid transfer" }, "buyers_item_id": { "type": "string", "description": "The buyer's identifier for this item", "example": "BUY-ITEM-9901" }, "sellers_item_id": { "type": "string", "description": "The seller's identifier for this item", "example": "PUMP-X500-BLK" }, "standard_item_id": { "type": "string", "description": "A standardised item identifier (e.g. GTIN, EAN)", "example": "09501101530003" }, "standard_item_scheme": { "type": "string", "description": "The scheme identifier for the standard item identifier", "example": "0160" }, "origin_country_code": { "type": "string", "description": "The ISO 3166-1 alpha-2 code of the item's country of origin", "example": "DE" }, "hs_code": { "type": "string", "description": "The Harmonized System (HS) code for the item. See `GET /resources/hs-codes` for the GCC Integrated Customs Tariff codes (12 digits, no separators); the value is not validated against that list yet.", "example": "841370000001" }, "commodity_code": { "type": "string", "description": "The commodity type code (G for goods, S for services, B for both)", "example": "G" }, "service_accounting_code": { "type": "string", "description": "The Service Accounting Code for the item. See `GET /resources/service-codes` for suggested values (UN CPC Version 2.1 service codes); the value is not validated against that list yet.", "example": "83111" }, "item_properties": { "type": "array", "description": "Additional item attributes", "items": { "$ref": "#/components/schemas/ItemProperty" } }, "quantity": { "type": "number", "format": "double", "description": "The quantity of items on this line", "example": 10 }, "unit_of_measure_code": { "type": "string", "description": "The unit of measure code for the quantity and price", "example": "C62" }, "line_extension_amount": { "type": "number", "format": "double", "description": "The net amount for this line", "example": 5000 }, "tax_amount": { "type": "number", "format": "double", "description": "The VAT amount for this line", "example": 250 }, "price_amount": { "type": "number", "format": "double", "description": "The net price per unit (excluding VAT)", "example": 500 }, "price_discount": { "type": "number", "format": "double", "description": "The discount applied to the gross price to arrive at the net price", "example": 25 }, "gross_price": { "type": "number", "format": "double", "description": "The gross price per unit before any price discount", "example": 525 }, "tax_category_code": { "type": "string", "description": "The VAT category code for this line", "example": "S" }, "tax_rate": { "type": "number", "format": "double", "description": "The VAT rate for this line, between 0 and 1", "example": 0.05 }, "tax_exemption_reason_code": { "type": "string", "description": "The coded reason for VAT exemption on this line", "example": "DL8.46.1" }, "tax_exemption_reason": { "type": "string", "description": "The textual reason for VAT exemption on this line", "example": "Certain financial services" }, "tax_scheme_id": { "type": "string", "description": "The tax scheme identifier", "example": "VAT" }, "item_price_extension_amount": { "type": "number", "format": "double", "description": "The line total in AED (tax currency)", "example": 5250 }, "item_price_extension_tax_amount": { "type": "number", "format": "double", "description": "The VAT amount for this line in AED (tax currency)", "example": 262.5 }, "item_price_extension_tax_currency": { "type": "string", "description": "The currency of the item price extension amounts", "example": "AED" }, "order_line_reference": { "$ref": "#/components/schemas/OrderReference" }, "accounting_cost": { "type": "string", "description": "A textual value that specifies where to book the relevant data into the Buyer's financial accounts", "example": "CC-OPEX-001" }, "invoice_period": { "$ref": "#/components/schemas/InvoicePeriod" }, "allowance_charges": { "type": "array", "description": "Line-level allowances and charges", "items": { "$ref": "#/components/schemas/InvoiceItemAllowanceCharge" } }, "allowance_total_amount": { "type": "number", "format": "double", "description": "The total amount of all line-level allowances", "example": 25 }, "charge_total_amount": { "type": "number", "format": "double", "description": "The total amount of all line-level charges", "example": 0 }, "item_nature_code": { "type": "string", "description": "The nature code of the item, required when the tax category is reverse charge (AE)", "example": "DL8.48.8.2" } } }, "ReceivedInvoice": { "type": "object", "description": "Represents a UAE PINT-AE compliant invoice or credit note received from the Peppol network", "required": [ "id", "created_at", "updated_at", "active", "is_self_billed", "received_at", "accepted_at", "rejected_at", "reported_at", "status" ], "properties": { "id": { "type": "string", "description": "The unique DigiTax identifier for this received invoice", "example": "receivedinvoice_01KMFSMEYVCDV0150T6P4WECVR" }, "created_at": { "type": "string", "format": "date-time", "description": "The timestamp when this record was created on DigiTax", "example": "2026-07-14T10:00:00Z" }, "updated_at": { "type": "string", "format": "date-time", "description": "The timestamp when this record was last updated on DigiTax", "example": "2026-07-14T12:30:00Z" }, "active": { "type": "boolean", "description": "Whether this received invoice record is active on DigiTax", "example": true }, "is_self_billed": { "type": "boolean", "description": "Whether this invoice was received via the self-billed channel (C3)", "example": false }, "invoice_number": { "type": "string", "description": "The invoice number as assigned by the supplier", "example": "INV-2026-00001" }, "uuid": { "type": "string", "description": "The universally unique identifier (UUID) of the invoice", "example": "550e8400-e29b-41d4-a716-446655440000" }, "transaction_type_code": { "type": "string", "description": "A binary code identifying the applicable PINT-AE transaction types", "example": "10000001" }, "transaction_types": { "type": "array", "description": "The list of applicable PINT-AE transaction types", "items": { "type": "string", "enum": [ "FREE_TRADE_ZONE", "DEEMED_SUPPLY", "PROFIT_MARGIN_SCHEME", "SUMMARY_INVOICE", "CONTINUOUS_SUPPLY", "AGENT_BILLING", "SUPPLY_THROUGH_ECOMMERCE", "EXPORTS" ] }, "example": [ "FREE_TRADE_ZONE", "EXPORTS" ] }, "invoice_type_code": { "type": "string", "description": "The UN/CEFACT document type code", "example": "380" }, "credit_note_reason_code": { "type": "string", "description": "The coded reason for the credit note, present on credit notes", "example": "DL8.61.1.A" }, "credit_note_reason_description": { "type": "string", "description": "The textual description for the credit note reason, present on credit notes", "example": "Supply was cancelled" }, "issue_date": { "type": "string", "format": "date", "description": "The date the invoice was issued (YYYY-MM-DD)", "example": "2026-07-14" }, "issue_time": { "type": "string", "description": "The time the invoice was issued (HH:MM:SS)", "example": "10:00:00" }, "due_date": { "type": "string", "format": "date", "description": "The payment due date (YYYY-MM-DD)", "example": "2026-08-13" }, "tax_point_date": { "type": "string", "format": "date", "description": "The VAT point date (YYYY-MM-DD). Must be strictly before the issue_date.", "example": "2026-07-13" }, "document_currency_code": { "type": "string", "description": "The currency of the invoice amounts", "example": "AED" }, "tax_currency_code": { "type": "string", "description": "The tax accounting currency (always AED for UAE e-invoices)", "example": "AED" }, "tax_currency_exchange_rate": { "type": "number", "format": "double", "description": "The exchange rate between document currency and tax currency", "example": 1 }, "buyer_reference": { "type": "string", "description": "An identifier assigned by the Buyer used for internal routing purposes", "example": "BR-2024-00789" }, "accounting_cost": { "type": "string", "description": "A textual value that specifies where to book the relevant data into the Buyer's financial accounts", "example": "CAPEX-2024-Q4" }, "project_reference": { "type": "string", "description": "A reference to a project relating to this invoice", "example": "PROJ-JEBEL-2024" }, "note": { "type": "string", "description": "Free-text notes on the invoice", "example": "Thank you for your business" }, "payment_terms_note": { "type": "string", "description": "Textual description of the payment terms", "example": "Net 30 days" }, "invoice_period": { "$ref": "#/components/schemas/InvoicePeriod" }, "order_reference": { "$ref": "#/components/schemas/OrderReference" }, "billing_reference": { "type": "array", "description": "References to preceding invoices", "items": { "$ref": "#/components/schemas/DocumentReference" } }, "despatch_document_reference": { "$ref": "#/components/schemas/DocumentReference" }, "receipt_document_reference": { "$ref": "#/components/schemas/DocumentReference" }, "originator_document_reference": { "$ref": "#/components/schemas/DocumentReference" }, "contract_document_reference": { "$ref": "#/components/schemas/DocumentReference" }, "additional_documents": { "type": "array", "description": "References to additional supporting documents", "items": { "$ref": "#/components/schemas/DocumentReference" } }, "delivery": { "$ref": "#/components/schemas/InvoiceDelivery" }, "allowance_charges": { "type": "array", "description": "Document-level allowances and charges", "items": { "$ref": "#/components/schemas/InvoiceAllowanceCharge" } }, "supplier_party": { "$ref": "#/components/schemas/ReceivedParty" }, "customer_party": { "$ref": "#/components/schemas/ReceivedParty" }, "payee_party": { "$ref": "#/components/schemas/ReceivedParty" }, "tax_representative_party": { "$ref": "#/components/schemas/ReceivedParty" }, "line_extension_amount": { "type": "number", "format": "double", "description": "The sum of all invoice line net amounts", "example": 10000 }, "tax_exclusive_amount": { "type": "number", "format": "double", "description": "The total amount without VAT", "example": 9500 }, "tax_inclusive_amount": { "type": "number", "format": "double", "description": "The total amount including VAT", "example": 9975 }, "payable_amount": { "type": "number", "format": "double", "description": "The amount due for payment", "example": 9975 }, "allowance_total_amount": { "type": "number", "format": "double", "description": "The sum of all document-level allowances", "example": 500 }, "charge_total_amount": { "type": "number", "format": "double", "description": "The sum of all document-level charges", "example": 0 }, "prepaid_amount": { "type": "number", "format": "double", "description": "The amount already paid to be deducted from the payable amount", "example": 0 }, "payable_rounding_amount": { "type": "number", "format": "double", "description": "The rounding amount added to make the payable amount a round number", "example": 0 }, "tax_amount": { "type": "number", "format": "double", "description": "The total VAT amount for the invoice", "example": 475 }, "tax_included_indicator": { "type": "boolean", "description": "Indicates whether VAT is included in the invoice line amounts", "example": false }, "tax_amount_in_tax_currency": { "type": "number", "format": "double", "description": "The VAT amount expressed in the tax currency (AED)", "example": 475 }, "beneficiary_tax_number": { "type": "string", "description": "The TRN or TIN of the beneficiary in case of Free Trade Zone supply", "example": "100111222300003" }, "principle_trn": { "type": "string", "description": "The TRN of the principal in case of Disclosed Agent billing", "example": "100333444500003" }, "status": { "type": "string", "description": "The AP workflow status of the received invoice", "enum": [ "RECEIVED", "ACCEPTED", "REJECTED", "REPORTED" ], "example": "RECEIVED" }, "document_type": { "type": "string", "description": "The document classification derived from invoice_type_code at ingest time", "enum": [ "RECEIVED_INVOICE_TYPE_UNSPECIFIED", "RECEIVED_INVOICE_TYPE_INVOICE", "RECEIVED_INVOICE_TYPE_CREDIT_NOTE" ], "example": "RECEIVED_INVOICE_TYPE_INVOICE" }, "lines": { "type": "array", "description": "The invoice line items", "items": { "$ref": "#/components/schemas/ReceivedInvoiceLine" } }, "payment_means": { "type": "array", "description": "Payment means for this invoice", "items": { "$ref": "#/components/schemas/ReceivedPaymentMeans" } }, "tax_subtotals": { "type": "array", "description": "The VAT breakdown by category", "items": { "$ref": "#/components/schemas/TaxBreakdown" } }, "received_at": { "type": "string", "format": "date-time", "nullable": true, "description": "The timestamp when the document first arrived from the Peppol network", "example": "2026-07-14T10:00:00Z" }, "accepted_at": { "type": "string", "format": "date-time", "nullable": true, "description": "The timestamp when the AP approved this invoice", "example": "2026-07-14T10:00:00Z" }, "rejected_at": { "type": "string", "format": "date-time", "nullable": true, "description": "The timestamp when the AP rejected this invoice", "example": null }, "reported_at": { "type": "string", "format": "date-time", "nullable": true, "description": "The timestamp when this invoice was forwarded to the FTA", "example": "2026-07-14T10:00:00Z" }, "acknowledged_at": { "type": "string", "format": "date-time", "nullable": true, "description": "The timestamp when a human at the business confirmed they've seen this invoice. Business-level only — separate from the automated Peppol MLS.", "example": null }, "acknowledged_by": { "type": "string", "nullable": true, "description": "The actor ID that acknowledged this invoice", "example": null } } } }, "responses": { "Error": { "description": "Error response", "content": { "application/json": { "schema": { "type": "object", "required": [ "message", "code" ], "properties": { "message": { "type": "string", "example": "An error occurred" }, "code": { "type": "string", "example": "400" }, "metadata": { "type": "object", "additionalProperties": { "type": "string" } } } } } } } }, "securitySchemes": { "apiKeyAuth": { "type": "apiKey", "in": "header", "name": "X-API-Key" } } } } ```