Consultar metadatos (CUFE/CUDE) de un documento de Facturación Electrónica#
Con este servicio se podrá consultar los metadatos, es decir los datos básicos de los documentos electrónicos transmitidas asincrónicamente.
Para hacer el consumo de la API se deben tener en cuenta en que entorno se va a trabajar, SOVOS Saphety cuenta con dos ambientes especificados en el apartado de Entornos.
Consumo del método de consulta de metadatos (CUFE/CUDE).#
El Verbo Http (acción) que se utiliza para la consulta de estado de este documento es:
GET
El método que se utiliza para la consulta de este documento es:
/v2/{virtualOperator}/outbounddocuments/{documentId}
Para esta petición se requiere como parámetro el alias de su operador virtual y el código identificador único del documento emitido.
Parámetro 1 - virtualOperator
Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.
Parámetro 2 - DocumentId
Recuerde reemplazar en el método el parámetro {DocumentId} con el código identificador único del documento emitido.
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": {
"DocumentStatusReason": "test",
"DocumentStatusReasonCode": "Item_01",
"PaymentStatus": "Unknown",
"PaymentCorrelationId": null,
"IsPdfGenerated": true,
"Id": "742b3857-8adb-4e48-afec-2e165303ccb7",
"DocumentType": "SalesInvoice",
"DocumentSubType": null,
"DocumentNumber": "SETP990053146",
"OriginId": "037ddade-c8b1-4dba-9513-5ee955841197",
"OriginName": "Saphety Transacciones Electrónicas S.A.S",
"OriginCode": "CO_NIT_900606963",
"DestinationId": "00000000-0000-0000-0000-000000000000",
"DestinationName": "Saphety Transacciones Electrónicas S.A.S",
"DestinationCode": "CO_NIT_900606963",
"DocumentDate": "2023-02-13T17:12:12Z",
"CreationDate": "2023-02-09T22:50:34.3766667Z",
"DocumentStatus": "Rejected",
"DocumentStatusDate": "2023-02-21T16:44:21.478164Z",
"DocumentStatusApplicationResponseInvalidSignature": false,
"CommunicationStatus": null,
"CommunicationStatusComments": null,
"MainEmailNotification": "correo@sovos.com",
"MainEmailNotificationStatus": "NotSent",
"MainEmailNotificationStatusReason": null,
"Currency": "COP",
"TotalAmount": 136850.0,
"Cufe": "bf64cbcd03eeb35b3971931958be205f8a54ec2163074e8ac56952b84b13af776a166d6e8cc6f8a442563154cd57812f"
},
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": "Id",
"Code": "DocumentNotFound",
"Description": null,
"ExplanationValues": [
"742b3857-8adb-4e48-afec-2e165303ccb6"
]
}
],
"ResultData": null,
"ResultCode": 400
}
Important
Si al realizar la consulta la respuesta es “Code”: “DocumentNotFound” y desea saber la Obtener Estado o Causales de Rechazo, puede consultarlo por el siguiente enlace Obtener Estado o Causales de Rechazo.
Referencia: Swagger#
Si quieres más información dirígete a Swagger que es el modelo del API de SOVOS Saphety, para el ambiente de QA https://api-factura-electronica-co-qa.saphety.com/swagger/index.html y para el ambiente de producción https://api-factura-electronica-co.saphety.com/swagger/index.html