Creación de Documentos de Recepción#
Con este servicio, se pueden subir el AttachedDocument y el PDF de los documentos recibidos para que queden registrados en nuestra plataforma SaphetyDoc.
Para consumir la API, es importante considerar el entorno en el que se va a trabajar. SOVOS Saphety dispone de dos ambientes, los cuales se especifican en el apartado de Entornos.
Consumo del método de Creación.#
El Verbo Http (acción) que se utiliza para la creación de este documento es:
POST
El método que se utiliza para la creación de este documento es:
/v2/{virtualOperator}/inbounddocuments/{companyId}/attacheddocument
Para esta petición se requiere como parámetro el alias de su operador virtual y el codigo de la compañia companyId.
Parametro 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”.
Parametro companyId
Recuerde reemplazar en el método el parámetro {companyId} con el codigo identificador unico de la empresa.
Body#
Estructura del mensaje JSON para crear documentos recibidos.#
A continuación encontrará la estructura base definida por Saphety para la creación de un Documento Electrónico recibido.
JSON (DTO)
{
"AttachedDocument": {
"Filename": "fv09006069630252200000DD5.xml",
"Content": "Attached Document codificado en base64",
"ContentType": "application/xml"
},
"Pdf": {
"Filename": "fv09006069630252200000DD5.pdf",
"Content": "PDF codificado en base64",
"ContentType": "application/pdf"
}
}
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": "276713cd-939e-4b37-b25f-26b7131b7d7e",
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": "CufeOrCude",
"Code": "Duplicated",
"Description": "Cufe/cude already exists: 32a00490ed9d615b31ca3ced8033c970e6c4e931e8b3ddb7cccf72fce019e2c4285e63412165538d162c1072c5a648a4. DocumentId: 13149871-d386-45f9-aa3a-bedfcba6d14c",
"ExplanationValues": []
}
],
"ResultData": "00000000-0000-0000-0000-000000000000",
"ResultCode": 400
}
Referencia: Swagger#
Para obtener más información, puedes consultar la documentación del API de SOVOS Saphety en Swagger. A continuación, se indican los enlaces según el ambiente:
Ambiente de QA: https://api-factura-electronica-co-qa.saphety.com/swagger/index.html
Ambiente de Producción: https://api-factura-electronica-co.saphety.com/swagger/index.html