Contingencia Tipo 3 para Factura de Venta Electronica#
La factura de contingencia se presenta cuando el EMISOR tiene una falla tecnológica (falla del erp, falla de internet, falla del proveedor tecnológico, etc.) y se necesita en ese momento emitir una factura de venta a un adquiriente.
Importante |
|
|---|---|
|
Se debe solicitar la respectiva numeración consecutiva con su vigencia autorizada por la DIAN. |
|
Las Fechas de generación y la numeración para las facturas electrónicas por contingencia, deben ser la misma que se relacionaron en la factura generada a papel. |
|
El facturador podrá emitir facturas de contingencia durante el tiempo que dure la contingencia. |
Existen dos tipos de contingencia, las cuales, puede adoptar de acuerdo de donde provenga el inconveniente tecnológico, sin embargo, en este manual SOLO explicaremos la contingencia tipo 03.
Contingencia por parte del Facturador Electrónico (Contingencia TIPO 003).
Contingencia por parte de la DIAN (Contingencia TIPO 004).
Contingencia por parte del FACTURADOR ELECTRÓNICO#
(CONTINGENCIA TIPO 003, INCONVENIENTES TECNOLÓGICOS)
Se utiliza cuando la plataforma del Facturador Electrónico o el Proveedor Tecnológico presentan un inconveniente tecnológico (no tiene energía, no tiene Internet o cualquier limitante técnica).
Que se debe hacer:
.
Creación de una Factura Electrónica de Venta por contingencia (FVC).#
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 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}/outbounddocuments/contingencyInvoice
Para esta petición se requiere como parámetro el alias de su operador virtual.
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”.
Body#
Estructura del mensaje JSON de una Factura Electrónica de Venta por contingencia (FVC).#
A continuación encontrará la estructura Base definida por Saphety para la creación de una Factura Electrónica de Venta por contingencia (FVC).
1. DocumentReferred (Factura Electrónica de Venta por contingencia (FVC))
Invoice.DocumentReferences.DocumentReferred
/Invoice/cac:ContingencyReference/cbc:ID
Prefijo y consecutivo del documento que se genero como contingencia a papel.
2. IssueDate (Factura Electrónica de Venta por contingencia (FVC))
Invoice.DocumentReferences.OrderReference.IssueDate
/Invoice/cac:OrderReference/cbc:IssueDate
Fecha y hora de generación del documento de contingencia a papel.
Formato fecha aaaa-mm-ddThh:mm:ss.
1. ContingencyReference (Factura Electrónica de Venta por contingencia (FVC))
Invoice.DocumentReferences.Type
/Invoice/cac:ContingencyReference
Relacionar el tipo de referencia en este caso para contingencia tipo 3 es “ContingencyReference”.
El listado de los tipos de DocumentReferences están disponibles en el método del WEB API de Saphety: DocumentReferences.
DTO Factura Electrónica de Venta por contingencia (FVC)#
JSON (DTO)
{
"Currency": "COP",
"SeriePrefix": "CFV",
"SerieNumber": "32",
"IssueDate": "2023-11-27T12:12:12",
"DueDate": "2023-11-27T12:12:12",
"DeliveryDate": "2023-11-27T12:12:12",
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"SerieExternalKey": "{{serieexternalkeyCFV}}",
"DocumentReferences": [
{
"DocumentReferred": "SETT9999", // prefijo y consecutivo del documento que se genero como contingencia a papel.
"IssueDate": "2022-07-29T00:09:26", // fecha y hora de generación del documento de contingencia a papel.
"Type": "ContingencyReference" // relacionar el tipo de referencia en este caso para contingencia tipo 3 es "ContingencyReference".
}
],
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"CustomerParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
},
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Address": {
"DepartmentCode": "11",
"CityCode": "11001",
"AddressLine": "Calle 97a No. 9 - 45",
"Country": "CO"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00"
}
}
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": "25ed3777-ba70-4fd9-b019-d9dbeb1495ab",
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": "SalesInvoice.Currency",
"Code": "Required",
"Description": null,
"ExplanationValues": []
}
],
"ResultData": "00000000-0000-0000-0000-000000000000",
"ResultCode": 400
}
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