{"id":39246,"date":"2026-08-11T16:13:27","date_gmt":"2026-08-11T15:13:27","guid":{"rendered":"https:\/\/developers.ila.cegid.com\/yet\/\/"},"modified":"2026-08-11T16:13:27","modified_gmt":"2026-08-11T15:13:27","slug":"how-to-check-document-traceability-and-notifications","status":"publish","type":"yet","link":"https:\/\/developers.ila.cegid.com\/en\/yet\/documents\/standard-scope\/article\/how-to-check-document-traceability-and-notifications","title":{"rendered":"How to check document traceability and notifications?"},"content":{"rendered":"

This article covers how to check the latest traceability<\/strong> of a document, how to retrieve the latest notifications<\/strong>, and what the possible document status<\/strong> values mean.<\/p>\n<\/div><\/section>\n

Receive latest document traceability<\/h2>\n

This endpoint returns the latest traceability of a specific<\/strong> document<\/strong> through its identifier<\/strong>. This identifier is returned by the Send documents<\/a> request.<\/p>\n

To retrieve the latest traceability, send the following request:<\/p>\n\n\n\n\n\n\n
Type<\/td>\nGET<\/td>\n<\/tr>\n
Production<\/td>\nhttps:\/\/yet.cegid.cloud\/EDIV2\/api\/v1.3\/ External\/Transaction\/{transactionId}\/Traceability\/Latest<\/td>\n<\/tr>\n
Testing<\/td>\nhttps:\/\/st.yet.cegid.cloud \/EDIV2\/api\/v1.3\/ External\/Transaction\/{transactionId}\/Traceability\/Latest<\/td>\n<\/tr>\n
Response<\/td>\n200 Ok
\n{
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“log”: “string”,
\n“traceabilityFiles”: [
\n{
\n“file”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“fileType”: “JSON”,
\n“fileTag”: “CertificateContractSent”,
\n“content”: “string”,
\n“extension”: “string”,
\n“mimeType”: “string”,
\n“fileName”: “string”,
\n“createdAt”: “2025-02-23T23:57:56.014Z”
\n},
\n“fileTag”: “CertificateContractSent”
\n}
\n]
\n}
\n409 Conflit or 500 Internal Server Error:
\n{
\n“type”: “string”,
\n“title”: “string”,
\n“status”: 0,
\n“detail”: “string”,
\n“instance”: “string”,
\n“additionalProp1”: “string”,
\n“additionalProp2”: “string”,
\n“additionalProp3”: “string”
\n}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div><\/section>\n

Get latest notifications<\/h2>\n

Use this request to check a document’s latest notification, which reflects the document’s current state. You’ll need the transaction identifier<\/strong> returned by the Send documents<\/a> request. If the document is in error, the response includes notification notes with more detail.<\/p>\n

You can also skip filtering by a specific document and retrieve all notifications from a given date onward instead. To do this, filter by createdAt<\/strong> greater than the desired date, and, since these are outbound transactions, include transaction\/direction = false<\/strong>.<\/p>\n

To retrieve the latest notifications, send the following request:<\/p>\n\n\n\n\n\n\n\n\n
Type<\/td>\nGET<\/td>\n<\/tr>\n
Production<\/td>\nhttps:\/\/yet.cegid.cloud\/EDIV2\/api\/v1.3\/External\/Notification?$count=true&$orderby=date
\ndesc&$filter=Transaction\/id eq {{TransactionId}}<\/td>\n<\/tr>\n
Testing<\/td>\nhttps:\/\/st.yet.cegid.cloud\/EDIV2\/api\/v1.3\/External?$count=true&$orderby=date
\ndesc&$filter=Transaction\/id eq {{TransactionId}}<\/td>\n<\/tr>\n
Alternative filter for all notifications from a specific date<\/td>\n$filter=createdAt ge {{StartDate}} and transaction\/direction eq false<\/td>\n<\/tr>\n
Route params<\/td>\ntransactionId: \u201cguid\u201d \/\/ identifier of the document created<\/td>\n<\/tr>\n
Response<\/td>\n{
\n“items”: [
\n{
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“notificationState”: “ErrorOccurred”,
\n“notificationType”: “Send”,
\n“notificationNoteType”: “SecurityError”,
\n“date”: “2025-02-24T00:02:16.527Z”,
\n“transaction”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“docType”: “string”,
\n“docNumber”: “string”,
\n“docDate”: “2025-02-24T00:02:16.527Z”,
\n“docDescription”: “string”,
\n“buyerGln”: “string”,
\n“deliveryGln”: “string”,
\n“invoiceToGln”: “string”,”supplierGln”: “string”,
\n“b2centity”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“codeIdentifier”: “string”,
\n“email”: “string”,
\n“mobilePhone”: “string”,
\n“contacts”: [
\n{
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“email”: “string”,
\n“enable”: true,
\n“mobilePhone”: “string”,
\n“sendMailType”: “CC”
\n}
\n]
\n},
\n“documentType”: “Generic”,
\n“documentExtenion”: “EDI”,
\n“comercialRelation”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“senderOrganization”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“communicationType”: “AS2”,
\n“integrationType”: “EDI”,
\n“documentExtension”: “EDI”,
\n“b2bformat”: “PRI”,
\n“erpProviderId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“identifier”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“name”: “string”,
\n“invoiceRepository”: true,
\n“autoComercialRelation”: true,
\n“mainDeliveryPlace”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“name”: “string”,
\n“address”: “string”,
\n“city”: “string”,
\n“country”: “string”,
\n“postalCode”: “string”,
\n“vatNumber”: “string”
\n},
\n“organizationInfo”: {
\n“billingCommission”: true,<\/p>\n

“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“vatNumber”: “string”,
\n“organizationType”: “string”
\n}
\n},
\n“receiverOrganization”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“communicationType”: “AS2”,
\n“integrationType”: “EDI”,
\n“documentExtension”: “EDI”,
\n“b2bformat”: “PRI”,
\n“erpProviderId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“identifier”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“name”: “string”,
\n“invoiceRepository”: true,
\n“autoComercialRelation”: true,
\n“mainDeliveryPlace”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“name”: “string”,
\n“address”: “string”,
\n“city”: “string”,
\n“country”: “string”,
\n“postalCode”: “string”,
\n“vatNumber”: “string”
\n},
\n“organizationInfo”: {
\n“billingCommission”: true,
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“vatNumber”: “string”,
\n“organizationType”: “string”
\n}
\n},
\n“documentType”: “Generic”,
\n“van”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“username”: “string”,
\n“password”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“ssl”: “string”,
\n“port”: “string”,<\/p>\n

“testName”: “string”,
\n“testUsername”: “string”,
\n“testPassword”: “string”,
\n“testInboundPath”: “string”,
\n“testOutboundPath”: “string”,
\n“testSSL”: “string”,
\n“testPort”: “string”,
\n“endPointUrl”: “string”,
\n“useWs”: true
\n},
\n“active”: true,
\n“isOnTeste”: true,
\n“mapName”: “string”,
\n“isPDFMandatory”: true,
\n“isJasminSync”: true,
\n“layoutReceiver”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“organization”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“communicationType”: “AS2”,
\n“integrationType”: “EDI”,
\n“documentExtension”: “EDI”,
\n“b2bformat”: “PRI”,
\n“erpProviderId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“identifier”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“name”: “string”,
\n“invoiceRepository”: true,
\n“autoComercialRelation”: true,
\n“mainDeliveryPlace”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“name”: “string”,
\n“address”: “string”,
\n“city”: “string”,
\n“country”: “string”,
\n“postalCode”: “string”,
\n“vatNumber”: “string”
\n},
\n“organizationInfo”: {
\n“billingCommission”: true,
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“vatNumber”: “string”,
\n“organizationType”: “string”
\n}<\/p>\n

},
\n“layoutDocument”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“layoutId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“documentTypeEnum”: “Generic”,
\n“direction”: true,
\n“mapa”: “string”,
\n“formatTypeEnum”: “XML”,
\n“segmento”: “string”,
\n“separator”: “string”,
\n“senderStart”: “string”,
\n“senderEnd”: “string”,
\n“receiverStart”: “string”,
\n“receiverEnd”: “string”,
\n“documentTypeStart”: “string”,
\n“documentTypeEnd”: “string”,
\n“documentTypeFileCode”: “string”,
\n“numberStart”: “string”,
\n“numberEnd”: “string”,
\n“dateStart”: “string”,
\n“dateEnd”: “string”,
\n“dateFormat”: “string”,
\n“bpPreExecution”: “string”,
\n“bpPosExecution”: “string”,
\n“layout”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“description”: “string”,
\n“layoutDocuments”: [
\n“string”
\n]
\n},
\n“van”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“username”: “string”,
\n“password”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“ssl”: “string”,
\n“port”: “string”,
\n“testName”: “string”,
\n“testUsername”: “string”,
\n“testPassword”: “string”,
\n“testInboundPath”: “string”,
\n“testOutboundPath”: “string”,
\n“testSSL”: “string”,<\/p>\n

“testPort”: “string”,
\n“endPointUrl”: “string”,
\n“useWs”: true
\n}
\n},
\n“layoutDefault”: true
\n},
\n“layoutSender”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“organization”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“communicationType”: “AS2”,
\n“integrationType”: “EDI”,
\n“documentExtension”: “EDI”,
\n“b2bformat”: “PRI”,
\n“erpProviderId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“identifier”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“name”: “string”,
\n“invoiceRepository”: true,
\n“autoComercialRelation”: true,
\n“mainDeliveryPlace”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“name”: “string”,
\n“address”: “string”,
\n“city”: “string”,
\n“country”: “string”,
\n“postalCode”: “string”,
\n“vatNumber”: “string”
\n},
\n“organizationInfo”: {
\n“billingCommission”: true,
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“vatNumber”: “string”,
\n“organizationType”: “string”
\n}
\n},
\n“layoutDocument”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“layoutId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“documentTypeEnum”: “Generic”,
\n“direction”: true,
\n“mapa”: “string”,
\n“formatTypeEnum”: “XML”,<\/p>\n

“segmento”: “string”,
\n“separator”: “string”,
\n“senderStart”: “string”,
\n“senderEnd”: “string”,
\n“receiverStart”: “string”,
\n“receiverEnd”: “string”,
\n“documentTypeStart”: “string”,
\n“documentTypeEnd”: “string”,
\n“documentTypeFileCode”: “string”,
\n“numberStart”: “string”,
\n“numberEnd”: “string”,
\n“dateStart”: “string”,
\n“dateEnd”: “string”,
\n“dateFormat”: “string”,
\n“bpPreExecution”: “string”,
\n“bpPosExecution”: “string”,
\n“layout”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“description”: “string”,
\n“layoutDocuments”: [
\n“string”
\n]
\n},
\n“van”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“username”: “string”,
\n“password”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“ssl”: “string”,
\n“port”: “string”,
\n“testName”: “string”,
\n“testUsername”: “string”,
\n“testPassword”: “string”,
\n“testInboundPath”: “string”,
\n“testOutboundPath”: “string”,
\n“testSSL”: “string”,
\n“testPort”: “string”,
\n“endPointUrl”: “string”,
\n“useWs”: true
\n}
\n},
\n“layoutDefault”: true
\n}
\n},<\/p>\n

“van”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“name”: “string”,
\n“username”: “string”,
\n“password”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“ssl”: “string”,
\n“port”: “string”,
\n“testName”: “string”,
\n“testUsername”: “string”,
\n“testPassword”: “string”,
\n“testInboundPath”: “string”,
\n“testOutboundPath”: “string”,
\n“testSSL”: “string”,
\n“testPort”: “string”,
\n“endPointUrl”: “string”,
\n“useWs”: true
\n},
\n“transactionState”: “PendingParser”,
\n“transactionType”: “QuickInvoice”,
\n“organizationOwner”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“communicationType”: “AS2”,
\n“integrationType”: “EDI”,
\n“documentExtension”: “EDI”,
\n“b2bformat”: “PRI”,
\n“erpProviderId”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“identifier”: “string”,
\n“inboundPath”: “string”,
\n“outboundPath”: “string”,
\n“name”: “string”,
\n“invoiceRepository”: true,
\n“autoComercialRelation”: true,
\n“mainDeliveryPlace”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“name”: “string”,
\n“address”: “string”,
\n“city”: “string”,
\n“country”: “string”,
\n“postalCode”: “string”,
\n“vatNumber”: “string”
\n},
\n“organizationInfo”: {
\n“billingCommission”: true,
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,<\/p>\n

“name”: “string”,
\n“vatNumber”: “string”,
\n“organizationType”: “string”
\n}
\n},
\n“alreadySent”: true,
\n“direction”: true,
\n“createdAt”: “2025-02-24T00:02:16.528Z”,
\n“documentDetails”: “string”
\n},
\n“notificationNotes”: [
\n{
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“note”: “string”
\n}
\n],
\n“errorCode”: “string”,
\n“invoiceRefusedMotive”: {
\n“id”: “3fa85f64-5717-4562-b3fc-2c963f66afa6”,
\n“code”: “string”,
\n“description”: “string”,
\n“createdAt”: “2025-02-24T00:02:16.528Z”,
\n“createdBy”: “string”
\n}
\n}
\n],
\n“nextPageLink”: “string”,
\n“count”: 0
\n}
\n400 Bad Request or 500 Internal Server Error:
\n{
\n“type”: “string”,
\n“title”: “string”,
\n“status”: 0,
\n“detail”: “string”,
\n“instance”: “string”,
\n“additionalProp1”: “string”,
\n“additionalProp2”: “string”,
\n“additionalProp3”: “string”
\n}<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div><\/section>\n

Document status values<\/h2>\n

A document goes through several processing steps before reaching its destination. Use the Get latest notifications<\/strong> request above to check whether a document has been sent<\/strong>, is pending<\/strong>, or has run into an error<\/strong>.<\/p>\n\n\n\n\n\n\n\n
Status<\/strong><\/td>\nDescription<\/strong><\/td>\n<\/tr>\n
PendingParser<\/strong><\/td>\nThe document is in queue to be processed.<\/td>\n<\/tr>\n
PendingSend<\/strong><\/td>\nThe document is pending to be sent by email.<\/td>\n<\/tr>\n
Error<\/strong><\/td>\nThe document has an error in its structure or is missing some configuration (see the notification notes).<\/td>\n<\/tr>\n
Sent<\/strong><\/td>\nThe document has been sent.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Note:<\/strong> After a document is sent to its destination and is in the Sent<\/strong> state, it is still possible to get errors returned by the receiver.<\/p>\n<\/div><\/section>\n","protected":false},"excerpt":{"rendered":"","protected":false},"featured_media":0,"menu_order":0,"comment_status":"open","ping_status":"open","template":"","format":"standard","tags":[1092,1093,1094],"videos_tax":[],"post-type":[300],"categoria-yet":[1081],"class_list":["post-39246","yet","type-yet","status-publish","format-standard","hentry","tag-traceability","tag-notifications","tag-status","post-type-artigo","categoria-yet-standard-scope"],"_links":{"self":[{"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/yet\/39246","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/yet"}],"about":[{"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/types\/yet"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/comments?post=39246"}],"version-history":[{"count":0,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/yet\/39246\/revisions"}],"wp:attachment":[{"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/media?parent=39246"}],"wp:term":[{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/tags?post=39246"},{"taxonomy":"videos_tax","embeddable":true,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/videos_tax?post=39246"},{"taxonomy":"post-type","embeddable":true,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/post-type?post=39246"},{"taxonomy":"categoria-yet","embeddable":true,"href":"https:\/\/developers.ila.cegid.com\/en\/wp-json\/wp\/v2\/categoria-yet?post=39246"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}