Retrieve Invoice Status by ID

This API allows to retrieve the status of a specific invoice using invoice number.

1. Invoice Status v1

Request URI

Path Parameter	Type	Mandatory	Description
`invoiceNumber`	String	Y	Unique identifier for the invoice

Response Structure

Field	Type	Description
`status(0...∞)`	Array	List of invoice status objects
`invoiceNumber`	String	Invoice Number
`status`	String	Status of the invoice
`statusDocumentDate`	String	Status Document Date
`statusDocumentSituationChangeDate`	String	Status Situation Change Date
`createdDate`	String	Creation date
`lastModified`	String	Last modified date

Response Example

{ "status": [ { "invoiceNumber": "1545037150", "status": "", "statusDocumentDate": "20251205000000", "statusDocumentSituationChangeDate": "20251212193618", "createdDate": "2025-12-12T18:36:44.056Z", "lastModified": "2025-12-12T18:36:44.056Z" }, { "invoiceNumber": "1545037150", "status": "ERROR_EDIWIN", "statusDocumentDate": "20251205000000", "statusDocumentSituationChangeDate": "20251212123703", "createdDate": "2025-12-12T11:37:32.291Z", "lastModified": "2025-12-12T11:37:32.291Z" } ] }

2. Invoice Status v2

Request URI

Path Parameter	Type	Mandatory	Description
`invoiceNumber`	String	Y	Unique identifier for the invoice

Response Structure

Field	Type	Description
`status(0...∞)`	Array	List of invoice status objects
`invoiceNumber`	String	Invoice Number
`invoiceUUID`	String	Invoice UUID
`statusDocumentSender`	String	Status Document Sender
`statusDocumentReceiver`	String	Status Document Receiver
`documentType`	String	Document Type
`externalLink`	String	External Link
`file`	String	File
`status`	String	Status of the invoice
`statusDocumentDate`	String	Status Document Date
`statusDocumentSituationChangeDate`	String	Status Situation Change Date
`createdDate`	String	Creation date
`lastModified`	String	Last modified date
`status/ADDITIONAL_PROPERTIES(0...∞)`	Array	List of additional properties
`Name`	String	Name of the additional property
`Value`	String	Value of the additional property

Response Example

{ "status": [ { "invoiceNumber": "2515098572", "invoiceUUID": "B7EB1530E36948C764369E57677E42E4269EF055", "statusDocumentSender": "MYDATA_GR_EPROVIDER", "statusDocumentReceiver": "094191567", "status": "Success", "documentType": "XML_INV_INVOICEDOC", "externalLink": "https://s.edicom.eu/BfgfPFo2F11NxqSDzagklmfarhu0BFHGcMeEBSD1kMY", "file": "file", "statusDocumentDate": "202605111315", "ADDITIONAL_PROPERTIES": [ { "Name": "Mark", "Value": "400013525110458" }, { "Name": "Authcode", "Value": "53D1405600A03ED7ED11722739DAD044DCD7C2B0" } ] }, { "invoiceNumber": "2515098572", "statusDocumentSender": "MYDATA_GR_EPROVIDER", "statusDocumentReceiver": "094191567", "status": "ValidationError", "documentType": "XML_INV_INVOICEDOC", "file": "file", "statusDocumentDate": "202605111431", "ERROR_DETAILS": [ { "Error_code": "228", "Error_message": "The UID: B7EB1530E36948C764369E57677E42E4269EF055 is invalid . It has already been sent for another invoice (MARK:400013525110458 , AUTHENTICATION_CODE:53D1405600A03ED7ED11722739DAD044DCD7C2B0)" } ] } ] }

2.1 Status Filter

Request URI

Path Parameter	Type	Mandatory	Description
`invoiceNumber`	String	Y	Unique identifier for the invoice

Query Parameter	Type	Mandatory	Description
`filter`	String	Y	Filter identifier for the invoice

2.1.1 Retrieve Invoice QR Code by ID (filter=QRCODE)

Response Structure

Field	Type	Description
`status(0...∞)`	Array	List of invoice status objects
`invoiceUUID`	String	Invoice universally unique identifier
`externalLink`	String	QRCODE link
`status/ADDITIONAL_PROPERTIES(0...∞)`	Array	List of additional properties
`Name`	String	Name of the additional property
`Value`	String	Value of the additional property

Response Example

{ "status": [ { "invoiceUUID": "719C877722231F22D5E1FEC7F4257D5000350B2B", "externalLink": "https://s.edicom.eu/BQp7azW5TcMq2uOJXTOSvokdgzsJlanebFinLFRyH13", "ADDITIONAL_PROPERTIES": [ { "Name": "Mark", "Value": "400001961566290" }, { "Name": "Authcode", "Value": "4A2DA4BB4E12B7A15140C2303623947949A28374" } ] } ] }

version 33 as of 1 week ago by Stefano.Gallo

0 Comments

Please sign in to post a comment.

Retrieve Invoice Status by ID

0 Comments

Docs Navigation