Configuraciones de la API
Configuraciones básicas
Los valores entre "" corresponden a datos de tipo string
Creacion de Empresa
:
POST
/api/ubl2.1/config/nit_empresa/digito_verificacion_empresa
Debera conservar el "token" : "be39365a845d0bec5bc51fce01f82e565cdd67b6eda23b983ba6d1cfae2cdf4d" que es retornado y con él realizará las siguientes peticiones.
Request
{
"type_document_identification_id": 3,
"type_organization_id" : 1,
"type_regime_id" : 1,
"type_liability_id" : 117,
"business_name" : "NOMBRE EMPRESA",
"merchant_registration" : "00000-00",
"municipality_id" : 439,
"address" : "CLL 18A # 11 - 20",
"phone" : 0000000,
"email" : "api@dominio.com",
"id_administrator" : null,
"mail_host": null,
"mail_port" : null,
"mail_username" : null,
"mail_password" : null,
"mail_encryption" : null
}
Response in status 200
{
"success" : true,
"message" : "Empresa creada/actualizada con éxito",
"password" : "$2y$10$qWHENBNpl8s2ujLifx05A..Ag2qaacQMszCJPamZD.iDt5oWNpl5G",
"token" : "be39365a845d0bec5bc51fce01f82e565cdd67b6eda23b983ba6d1cfae2cdf4d",
"company" : {
"id" : 1,
"user_id" : 1,
"identification_number" : "901249232",
"dv" : "0",
"language_id" : 79,
"tax_id" : 1,
"type_environment_id" : 2,
"type_operation_id" : 10,
"type_document_identification_id" : 3,
"country_id" : 46,
"type_currency_id" : 35,
"type_organization_id" : 2,
"type_regime_id" : 1,
"type_liability_id" : 117,
"municipality_id" : 439,
"merchant_registration" : "00000-00,
"address" : "CLL 18A # 11 - 20",
"phone" : "0000000",
"created_at" : "2021-07-14 18:41:54",
"updated_at" : "2021-07-14 18:41:54",
"user" : {
"id" : 1,
"name" : "NOMBRE EMPRESA",
"email" : "api@dominio.com",
"email_verified_at" : null,
"created_at" : "2021-07-14 18:41:54",
"updated_at" : "2021-07-14 18:41:54",
"id_administrator" : null,
"mail_host" : null,
"mail_port" : null,
"mail_username" : null,
"mail_password" : mull,
"mail_encryption" : null
},
"send": []
}
}
Configurar Software
:
PUT
/api/ubl2.1/config/software
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"id": "a5c5fd4e-6910-4e36-b618-05eb6c762ff2",
"pin": 12345
}
Response in status 200
{
"success" : true,
"message" : "Software creado con éxito",
"software" : {
"identifier" : "a5c5fd4e-6910-4e36-b618-05eb6c762ff2",
"pin" : 12345,
"url" : "https://vpfe-hab.dian.gov.co/WcfDianCustomerServices.svc",
"updated_at" : "2021-07-14 18:44:15",
"created_at" : "2021-07-14 18:44:15",
"id" : 72
}
}
Configurar certificado
:
PUT
/api/ubl2.1/config/certificate
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"certificate": "MIIdcQIBAzCCHSoGCSqGSIb3DQEHAaCCHRsEgh0XMIIdEzCCBeoGCSqGSIb3DQEHAaCCBdsEggXXMIIF0zCCBc8GCyqGSIb3DQEMCgECoIIFQDCCBTwwZgYJKoZIhvcNAQUNMFkwOAYJKoZIhvcNAQUMMCsEFGHuOMyMDpwIJ49ufg2SGBUYlo+/AgInEAIBIDAMBggqhkiG9w0CCQUAMB0GCWCGSAFlAwQBKgQQ7ldBSVsWYLHqkNR2TJSnlwSCBNBWjIuTBCrVjC6rVeGs71SwRhHbfcC5p+n4bHGVdWZnUql4TDkJQW+0ePdRk8PfswDAmzlzo1jedEezZ15pTLy9Yu5R2Q8gk7EvFOGgCUKU+EiBxLXwm7F3TOOSCF2PR9NSzAV3qKflz99UoUFGUAU7Kiml3DDHF9Rj3YZUs4aOWp84xIn3PqY3x1uNcGrS1OWu70njQTUzgxXVLvUtPXy2C+X22Uy6a3fZZzHELA29EEeDfSuxrIxuXXAvq1QECDEX0kD/ImRq1NWhHqSk8TDwjnqIqRlt4/g+zahr80dT7znk+cFfThz6lItHm5B4FBZNcUBAkfPMzyKngqJ2IsE7PaPbuUrkvVkVYe904I2i8utuLYBJeRFl3256z3SXMfM74ryddPVxMgQ/gymxGiBunZA9c8riRTKvJSRXA/WRJD5rsoKIJXfpmPymRaYgfgHDxVrS31QhJi2xfBsHScgOYgeVjQMKLsHXJKIUX110ZFmpKQeaRM4/X71sk6Z+TRiHVJBhWabL3wzdXP3zPLT47XBIUa62T1HZTzMfrm2zZbyj",
"password": ""mi_clave_secreta"
}
Response in status 200
{
"success": true,
"message": "Certificado creado con éxito",
"certificado": {
"name": "nit_cliente.p12",
"password": "mi_clave_secreta",
"updated_at": "2021-07-14 18:44:37",
"created_at": "2021-07-14 18:44:37",
"id": 67
}
}
Configurar resoluciones
:
PUT
/api/ubl2.1/config/resolution
Resolución de NC
Headers
A continuación se muestran los datos de la resolución de prueba (Habilitación)
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
Resolución de Factura
{
"type_document_id": 1,
"prefix": "SETP",
"resolution": "18760000001",
"resolution_date": "2019-01-19",
"technical_key": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"from": 990000000,
"to": 995000000,
"generated_to_date": 0,
"date_from": "2019-01-19",
"date_to": "2030-01-19"
}
Resolución de NC
{
"type_document_id": 4,
"prefix": "ND",
"resolution": null,
"resolution_date": "2019-01-19",
"technical_key": null,
"from": 1,
"to": 99999999,
"generated_to_date": 0,
"date_from": null,
"date_to": null
}
Resolución de ND
{
"type_document_id": 5,
"prefix": "ND",
"resolution": null,
"resolution_date": "2019-01-19",
"technical_key": null,
"from": 1,
"to": 99999999,
"generated_to_date": 0,
"date_from": null,
"date_to": null
}
Response in status 200
Resolución de factura
{
"success" : true,
"message" : "Resolución creada/actualizada con éxito",
"resolution" : {
"type_document_id" : 1,
"resolution" : "18760000001",
"prefix" : "SETP",
"resolution_date" : "2019-01-19",
"technical_key" : "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
"from" : 990000000,
"to" : 995000000,
"date_from" : "2019-01-19",
"date_to" : "2030-01-19",
"updated_at" : "2021-07-14 18:45:11",
"created_at" : "2021-07-14 18:45:11",
"id" : 306,
"number" : 990000000,
"next_consecutive" : "SETP990000000"
}
}
Resolución de NC
{
"success" : true,
"message" : "Resolución creada/actualizada con éxito",
"resolution" : {
"type_document_id" : 4,
"resolution" : null,
"prefix" : "NC",
"resolution_date" : null,
"technical_key" : null,
"from" : 1,
"to" : 99999999,
"date_from" : null,
"date_to" : null,
"updated_at" : "2021-07-14 18:45:11",
"created_at" : "2021-07-14 18:45:11",
"id" : 307,
"number" : 1,
"next_consecutive" : "NC1"
}
}
Resolución de ND
{
"success" : true,
"message" : "Resolución creada/actualizada con éxito",
"resolution" : {
"type_document_id" : 5,
"resolution" : null,
"prefix" : "NC",
"resolution_date" : null,
"technical_key" : null,
"from" : 1,
"to" : 99999999,
"date_from" : null,
"date_to" : null,
"updated_at" : "2021-07-14 18:45:11",
"created_at" : "2021-07-14 18:45:11",
"id" : 307,
"number" : 1,
"next_consecutive" : "NC1"
}
}
Pruebas DIAN
Envio de una factura
:
POST
/api/ubl2.1/invoice/testsetId
* La fecha del documento no debe ser menor o mayor a 10 días desde la fecha actual.
El TestSetId es asignado por la DIAN
* Para superar las pruebas es necesario enviar de forma exitosa 8 Facturas, 1 Nota debito y 1 Nota Crédito* La fecha del documento no debe ser menor o mayor a 10 días desde la fecha actual.
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"number" : 990000001,
"type_document_id" : 1,
"date" : "2021-08-17",
"time" : "04:08:12",
"resolution_number" : "18760000001",
"prefix" : "SETP",
"notes" : "",
"disable_confirmation_text" : true,
"establishment_name" : "NOMBRE EMPRESA",
"establishment_address" : "CLL 18A 11 - 20",
"establishment_phone" : "3106031839",
"establishment_municipality" : 439,
"atacheddocument_name_prefix" : null,
"establishment_email" : "alternate_email@dominio.com",
"sendmail" : true,
"sendmailtome" : true,
"seze" : "2021-2017",
"head_note" : "NOTA EN EL ENCABEZADO DE PAGINA",
"foot_note" : "NOTA EN EL PIE DE PAGINA",
"customer" : {
"identification_number" : 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": 3106031839,
"address": "CLL 18A # 11 - 20,
"email": "email_cliente@dominio.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 439,
"type_regime_id": 1
},
"payment_form": {
"payment_form_id": 2,
"payment_method_id": 30,
"payment_due_date": "2021-09-17",
"duration_measure": "30"
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "50000.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "50000.00",
"payable_amount": "950000.00"
},
"tax_totals":
[
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19",
"taxable_amount": "840336.134"
}
],
"invoice_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "840336.134",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"taxable_amount": "840336.134",
"percent": "19.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "1000000.00",
"base_quantity": "1"
}
]
}
Response in status 200
Envio de Nota Credito
:
POST
/api/ubl2.1/credit-note/testsetId
el "uuid" corresponde al codigo CUFE del documento al cual se le desea aplicar la nota.
El TestSetId es asignado por la DIAN
Para superar las pruebas es necesario enviar de forma exitosa 8 Facturas, 1 Nota debito y 1 Nota Créditoel "uuid" corresponde al codigo CUFE del documento al cual se le desea aplicar la nota.
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"billing_reference" : {
"number" : "SETP990000001",
"uuid" : "d8493ae63b843cd360bccc50686ac08fa89d7f9b967b2093ab14b6809245bcfe360a19eb23361b45e9a95842a9ff225c",
"issue_date" : "2021-08-17"
},
"discrepancyresponsecode" : 2,
"discrepancyresponsedescription" : "PRUEBA DE MOTIVO NOTA CREDITO",
"notes" : "PRUEBA DE NOTA CREDITO",
"resolution_number" : "0000000000",
"prefix" : "NC",
"number" : 33,
"type_document_id" : 4,
"date" : "2021-08-17",
"time" : "06:00:13",
"establishment_name" : "NOMBRE EMPRESA",
"establishment_address" : "CLL 18A # 11 - 20",
"establishment_phone" : "3106031839",
"establishment_municipality" : 439,
"sendmail" : true,
"sendmailtome" : true,
"seze" : "2021-2017",
"head_note" : "nOTA EN EL ENCABEZADO DE PAGINA",
"foot_note" : "nOTA EN EL ENCABEZADO DE PAGINA",
"customer" : {
"identification_number" : 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": 3106031839,
"address": "CLL 18A # 11 - 20,
"email": "email_cliente@dominio.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 439,
"type_regime_id": 1
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "50000.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "50000.00",
"payable_amount": "950000.00"
},
"tax_totals":
[
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19",
"taxable_amount": "840336.134"
}
],
"credit_note_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "840336.134",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"taxable_amount": "840336.134",
"percent": "19.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "1000000.00",
"base_quantity": "1"
}
]
}
Response in status 200
{
"message": "Nota Crédito #NC1 generada con éxito",
"ResponseDian": {
"Envelope": {
"Header": {
"Action": {
"_attributes": {
"mustUnderstand": "1"
},
"_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendTestSetAsyncResponse"
},
"Security": {
"_attributes": {
"mustUnderstand": "1"
},
"Timestamp": {
"_attributes": {
"Id": "_0"
},
"Created": "2022-02-22T21:21:24.620Z",
"Expires": "2022-02-22T21:26:24.620Z"
}
}
},
"Body": {
"SendTestSetAsyncResponse": {
"SendTestSetAsyncResult": {
"ErrorMessageList": {
"_attributes": {
"nil": "true"
}
},
"ZipKey": "73667044-42d1-49aa-ac8e-387b656b68e9"
}
}
}
}
},
"invoicexml": "CiAgPC9jYWM6Q3JlZGl0Tm90ZUxpbmU+CjwvQ3JlZGl0Tm90ZT4K",
"reqfe": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwCjwvc29hcDpFbnZlbG9wZT4K",
"rptafe": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3d3dy53My5vcmcvMzpFbnZlbG9wZT4=",
"urlinvoicexml": "NCS-NC1.xml",
"urlinvoicepdf": "NCS-NC1.pdf",
"urlinvoiceattached": "Attachment-NC1.xml",
"cude": "15b99481aaeef382cb5d88c0bcdb758cbc401734b6e67dd9bb6655a34014ff9cf853b99604239357cb4275a29abd2168",
"QRStr": "NumCr: 1\nFecCr: 2021-09-28\nNitFac: 901500548\nDocAdq: 800194600\nValFac: 634338.00\nValIva: 0.00ValOtroIm: 0.00\nValTotal: 754862.22\nCUDE: 15b99481aaeef382cb5d88c0bcdb758cbc401734b6e67dd9bb6655a34014ff9cf853b99604239357cb4275a29abd2168\nhttps://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=15b99481aaeef382cb5d88c0bcdb758cbc401734b6e67dd9bb6655a34014ff9cf853b99604239357cb4275a29abd2168"
}
Envio de Nota Debito
:
POST
/api/ubl2.1/debit-note/testsetId
el "uuid" corresponde al codigo CUFE del documento al cual se le desea aplicar la nota.
El TestSetId es asignado por la DIAN
Para superar las pruebas es necesario enviar de forma exitosa 8 Facturas, 1 Nota debito y 1 Nota Créditoel "uuid" corresponde al codigo CUFE del documento al cual se le desea aplicar la nota.
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"billing_reference": {
"number": "11/04/2021",
"uuid": "d8493ae63b843cd360bccc50686ac08fa89d7f9b967b2093ab14b6809245bcfe360a19eb23361b45e9a95842a9ff225c",
"issue_date": "11/04/2021"
},
"number": 1,
"type_document_id": 5,
"date": "11/12/2021",
"time": "08:40:15",
"notes": "PRUEBA DE NOTA DEBITO",
"customer" : {
"identification_number" : 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": 3106031839,
"address": "CLL 18A # 11 - 20,
"email": "email_cliente@dominio.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 439,
"type_regime_id": 1
},
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"requested_monetary_totals": {
"line_extension_amount": "32000.00",
"tax_exclusive_amount": "0",
"tax_inclusive_amount": "32000.00",
"allowance_total_amount": "0",
"charge_total_amount": "0.00",
"payable_amount": "32000.00"
},
"debit_note_lines": [
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "32000.00",
"free_of_charge_indicator": false,
"allowance_charges": [
{
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "0.00",
"base_amount": "32000.00"
}
],
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "0.00",
"taxable_amount": "0.00",
"percent": "0.00"
}
],
"description": "PRUEBA DE NOTA DEBITO ELECTRONICA",
"code": "001NOTA",
"type_item_identification_id": 4,
"price_amount": "32000",
"base_quantity": "1"
}
]
}
{
"billing_reference" : {
"number" : "SETP990000001",
"uuid" : "d8493ae63b843cd360bccc50686ac08fa89d7f9b967b2093ab14b6809245bcfe360a19eb23361b45e9a95842a9ff225c",
"issue_date" : "2021-08-17"
},
"discrepancyresponsecode" : 2,
"discrepancyresponsedescription" : "PRUEBA DE MOTIVO NOTA CREDITO",
"notes" : "PRUEBA DE NOTA CREDITO",
"resolution_number" : "0000000000",
"prefix" : "NC",
"number" : 33,
"type_document_id" : 4,
"date" : "2021-08-17",
"time" : "06:00:13",
"establishment_name" : "NOMBRE EMPRESA",
"establishment_address" : "CLL 18A # 11 - 20",
"establishment_phone" : "3106031839",
"establishment_municipality" : 439,
"sendmail" : true,
"sendmailtome" : true,
"seze" : "2021-2017",
"head_note" : "nOTA EN EL ENCABEZADO DE PAGINA",
"foot_note" : "nOTA EN EL ENCABEZADO DE PAGINA",
"customer" : {
"identification_number" : 901249232,
"dv": 0,
"name": "NOMBRE EMPRESA",
"phone": 3106031839,
"address": "CLL 18A # 11 - 20,
"email": "email_cliente@dominio.com",
"merchant_registration": "0000000-00",
"type_document_identification_id": 6,
"type_organization_id": 1,
"type_liability_id": 117,
"municipality_id": 439,
"type_regime_id": 1
},
"allowance_charges": [
{
"discount_id": 1,
"charge_indicator": false,
"allowance_charge_reason": "DESCUENTO GENERAL",
"amount": "50000.00",
"base_amount": "1000000.00"
}
],
"legal_monetary_totals": {
"line_extension_amount": "840336.134",
"tax_exclusive_amount": "840336.134",
"tax_inclusive_amount": "1000000.00",
"allowance_total_amount": "50000.00",
"payable_amount": "950000.00"
},
"tax_totals":
[
{
"tax_id": 1,
"tax_amount": "159663.865",
"percent": "19",
"taxable_amount": "840336.134"
}
],
"credit_note_lines":
[
{
"unit_measure_id": 70,
"invoiced_quantity": "1",
"line_extension_amount": "840336.134",
"free_of_charge_indicator": false,
"tax_totals": [
{
"tax_id": 1,
"tax_amount": "159663.865",
"taxable_amount": "840336.134",
"percent": "19.00"
}
],
"description": "COMISION POR SERVICIOS",
"notes": "ESTA ES UNA PRUEBA DE NOTA DE DETALLE DE LINEA.",
"code": "COMISION",
"type_item_identification_id": 4,
"price_amount": "1000000.00",
"base_quantity": "1"
}
]
}
Response in status 200
{
"message": "Nota Débito #ND2 generada con éxito",
"ResponseDian": {
"Envelope": {
"Header": {
"Action": {
"_attributes": {
"mustUnderstand": "1"
},
"_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/SendTestSetAsyncResponse"
},
"Security": {
"_attributes": {
"mustUnderstand": "1"
},
"Timestamp": {
"_attributes": {
"Id": "_0"
},
"Created": "2022-02-22T21:22:07.043Z",
"Expires": "2022-02-22T21:27:07.043Z"
}
}
},
"Body": {
"SendTestSetAsyncResponse": {
"SendTestSetAsyncResult": {
"ErrorMessageList": {
"_attributes": {
"nil": "true"
}
},
"ZipKey": "781da7f6-55c1-46da-abbd-e50410dacdb1"
}
}
}
}
},
"invoicexml": "PD94bWwgdmVyGVMaW5lPgo8L0RlYml0Tm90ZT4K",
"zipinvoicexml": "UEsDBBQLAAAAyhYAAAAA",
"unsignedinvoicexml": "PD94blTGluZT4KPC9EZWJpdE5vdGU+Cg==",
"reqfe": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwOko8L3NvYXA6RW52ZWxvcGU+Cg==",
"rptafe": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3dPjwvczpCb2R5PjwvczpFbnZlbG9wZT4=",
"urlinvoicexml": "NDS-ND2.xml",
"urlinvoicepdf": "NDS-ND2.pdf",
"urlinvoiceattached": "Attachment-ND2.xml",
"cude": "5f0385486bf4130e626a9150fe3a7f5f6d12068a4e50c79ad32dcefae6f8f36ae8a28b76905e5e8dc083ea64f6dc4426",
"QRStr": "NumDb: 2\nFecDb: 2022-02-14\nNitFac: 901500548\nDocAdq: 901249232\nValFac: 0\nValIva: 0.00\nValOtroIm: 0.00\nValTotal: 32000.00\nCUDE: 5f0385486bf4130e626a9150fe3a7f5f6d12068a4e50c79ad32dcefae6f8f36ae8a28b76905e5e8dc083ea64f6dc4426\nhttps://catalogo-vpfe-hab.dian.gov.co/document/searchqr?documentkey=5f0385486bf4130e626a9150fe3a7f5f6d12068a4e50c79ad32dcefae6f8f36ae8a28b76905e5e8dc083ea64f6dc4426"
}
Consultar estado del documento
Consutar estado del documento by ZipKey
:
POST
/api/ubl2.1/status/zip/ZipKey
El ZipKey es retornado por el servicio de envio de documentos en el ambiente de prueba y tiene la siguiente forma: e3e4bb2b-9cb3-43ee-8077-d5ee704f92ba
En el ambiente de producción se retorna directamente el error y no es necesario realizar una segunda consulta!Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
Se indica el tipo de documento que se desea pasar a producción.
{
"type_environment_id": 1
}
Response in status 200
{
"message": "Consulta generada con éxito",
"ResponseDian": {
"Envelope": {
"Header": {
"Action": {
"_attributes": {
"mustUnderstand": "1"
},
"_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/GetStatusZipResponse"
},
"Security": {
"_attributes": {
"mustUnderstand": "1"
},
"Timestamp": {
"_attributes": {
"Id": "_0"
},
"Created": "2021-12-11T22:41:55.445Z",
"Expires": "2021-12-11T22:46:55.445Z"
}
}
},
"Body": {
"GetStatusZipResponse": {
"GetStatusZipResult": {
"DianResponse": {
"ErrorMessage": {
"_attributes": {
"nil": "true"
}
},
"IsValid": "false",
"StatusCode": "2",
"StatusDescription": "Set de prueba con identificador a2fde059-e3ae-46ff-8a63-55ba50f98ee4 es incorrecto.",
"StatusMessage": {
"_attributes": {
"nil": "true"
}
},
"XmlBase64Bytes": {
"_attributes": {
"nil": "true"
}
},
"XmlBytes": {
"_attributes": {
"nil": "true"
}
},
"XmlDocumentKey": {
"_attributes": {
"nil": "true"
}
},
"XmlFileName": {
"_attributes": {
"nil": "true"
}
}
}
}
}
}
}
},
"reqzip": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwOkVudmVsb3BlIHhtbG5zOnNvYXA9Imh0dHA6Ly93d3cudzMub3JnLzIwMDMvMDUvc29hcC1lbnZlbG9wZSIgeG1sbnM6d2NmPSJodHRwOi8vd2NmLmRpYW4uY29sb21iaWEiPjxzb2FwOkhlYWRlciB4bWxuczp3c2E9Imh0dHA6Ly93d3cudzMub3JnLzIwMDUvMDgvYWRkcmVzc2luZyI+PHdzc2U6U2VjdXJpdHkgeG1sbnM6d3NzZT0iaHR0cDovL2RvY3Mub2FzaXMtb3Blbi5vcmcvd3NzLzIwMDQvMDEvb2FzaXMtMjAwNDAxLXdzcy13c3NlY3VyaXR5LXNlY2V4dC0xLjAueHNkIiB4bWxuczp3c3U9Imh0dHA6Ly9kb2NzLm9hc2lzLW9wZW4ub3JnL3dzcy8yMDA0LzAxL29hc2lzLTIwMDQwMS13c3Mtd3NzZWN1cml0eS11dGlsaXR5LTEuMC54c2QiPjx3c3U6VGltZXN0YW1wIHdzdTpJZD0iVFMtMzBGMjY1NEU5QUYyRUI0OEY0QzFGOUU5QTRERjc2RDBGMTg4NTUyQyI+PHdzdTpDcmVhdGVkPjIwMjEtMTItMTFUMjI6NDE6NTVaPC93c3U6Q3JlYXRlZD48d3N1OkV4cGlyZXM+MjAyMS0xMi0xMlQxNToyMTo1NVo8L3dzdTpFeHBpcmVzPjwvd3N1OlRpbWVzdGFtcD48d3NzZTpCaW5hcnlTZWN1cml0eVRva2VuIEVuY29kaW5nVHlwZT0iaHR0cDovL2RvY3Mub2FzaXMtb3Blbi5vcmcvd3NzLzIwMDQvMDEvb2FzaXMtMjAwNDAxLXdzcy1zb2FwLW1lc3NhZ2Utc2VjdXJpdHktMS4wI0Jhc2U2NEJpbmFyeSIgVmFsdWVUeXBlPSJodHRwOi8vZG9jcy5vYXNpcy1vcGVuLm9yZy93c3MvMjAwNC8wMS9vYXNpcy0yMDA0MDEtd3NzLXg1MDktdG9rZW4tcHJvZmlsZS0xLjAjWDUwOXYzIiB3c3U6SWQ9IlRPUlJFU09GVFdBUkUtMTczNzE1QUY3MEY4ODk0NzJERENFODgzQjYxNUQ0RkE1Q0M0QzUyNyI+TUlJSElEQ0NCUWlnQXdJQkFnSUtTaDVlaSsydVl1QlFoREFOQmdrcWhraUc5dzBCQVFzRkFEQ0JoakVlTUJ3R0NTcUdTSWIzRFFFSkFSWVBhVzVtYjBCbmMyVXVZMjl0TG1Odk1TVXdJd1lEVlFRREV4eEJkWFJ2Y21sa1lXUWdVM1ZpYjNKa2FXNWhaR0VnTURFZ1IxTkZNUXd3Q2dZRFZRUUxFd05RUzBreEREQUtCZ05WQkFvVEEwZFRSVEVVTUJJR0ExVUVCeE1MUW05bmIzUmhJRVF1UXk0eEN6QUpCZ05WQkFZVEFrTlBNQjRYRFRJeE1URXlOREUzTXpJd01Gb1hEVEl5TVRFeU5ERTNNekl3TUZvd2dnRkdNUnd3R2dZRFZRUUpEQk5EVWlBNE5pQkVJRFkwSUVFZ1UxVlNJREE1TVVnd1JnWURWUVFOREQ5R1lXTjBkWEpoWkc5eUlFVnNaV04wY205dWFXTnZJRkF1U2lCd2IzSWdSMU5GSUVOaGJHeGxJRGN6SURjdE16RWdVR2x6YnlBeklGUnZjbkpsSUVJeEZEQVNCZ05WQkFnTUMwSlBSMDlVUVNCRUxrTXVNUlF3RWdZRFZRUUhEQXRDVDBkUFZFRWdSQzVETGpFbE1DTUdDU3FHU0liM0RRRUpBUllXWldScFoyVnliM052Y21sdlFHZHRZV2xzTG1OdmJURUxNQWtHQTFVRUJoTUNRMDh4SmpBa0JnTlZCQU1NSFVWWlJDQlBVMDlTU1U4Z1EwOU9VMVJTVlVORFNVOU9SVk1nVTBGVE1Sa3dGd1lLS3dZQkJBR2taZ0VEQWd3Sk9UQXhOVEUxTnpRNE1Rd3dDZ1lEVlFRcERBTk9TVlF4RWpBUUJnTlZCQVVUQ1Rrd01UVXhOVGMwT0RFWE1CVUdBMVVFQ3d3T1FXUnRhVzVwYzNSeVlYUnBkbUV3Z2dFaU1BMEdDU3FHU0liM0RRRUJBUVVBQTRJQkR3QXdnZ0VLQW9JQkFRQ1M0YTFURTF3QW0xb2F0MXhCRFdYeENBUFNIWCtBRGFJU2RobXU2bU1FK0l0SFluL3dHYmFaS0gvSFNuMkNHWDI5dEtnclk1TmY3UHNnZEI2cEhORHp2QUNUNCtzWHUveFlqTzZuOWw5MktOUEFrMVdtdGtYRitQMjJITlp3aUR1anUrajBsZG5JSjdab21ob3ZoZHRwVDJBbzhsRWxjS2xHR1FTNEJGZFExdXJKUUw2UUpVTTZUUHZWZDBtQm5JVXBZQkF3cndIcVVBVXRZdkV6cnR6blZPVlE5bDg0UlZWazVKeVNoaW0yZm02NlAxNWFXQ2hJSHF6TzFMNUJJdVhqK0xXek1taFd3YkR6QmpNaUI3bnhvby83RHBiVXFmaHNaSGxsdm90M0E5Z21lRmZ2UG12NFdWRzNqL2RlN3QxblJlR2Njc0NwbFNzQkhYZGdVc29qQWdNQkFBR2pnZ0hMTUlJQnh6QU1CZ05WSFJNQkFmOEVBakFBTUI4R0ExVWRJd1FZTUJhQUZFRzgxRGw0dUlPakZ4b0ltcW00QkFJSkxkaVpNR2dHQ0NzR0FRVUZCd0VCQkZ3d1dqQXlCZ2dyQmdFRkJRY3dBb1ltYUhSMGNITTZMeTlqWlhKMGN6SXVaM05sTG1OdmJTNWpieTlEUVY5VFZVSXdNUzVqY25Rd0pBWUlLd1lCQlFVSE1BR0dHR2gwZEhCek9pOHZiMk56Y0RJdVozTmxMbU52YlM1amJ6QWhCZ05WSFJFRUdqQVlnUlpsWkdsblpYSnZjMjl5YVc5QVoyMWhhV3d1WTI5dE1JR0RCZ05WSFNBRWZEQjZNSGdHQ3lzR0FRUUJnZk1nQVFRTE1Ha3dad1lJS3dZQkJRVUhBZ0VXVzJoMGRIQnpPaTh2WjNObExtTnZiUzVqYnk5a2IyTjFiV1Z1ZEc5ekwyTmhiR2xrWVdRdlJGQkRMMFJsWTJ4aGNtRmphVzl1WDJSbFgxQnlZV04wYVdOaGMxOWtaVjlEWlhKMGFXWnBZMkZqYVc5dVgxWXhNaTV3WkdZd0hRWURWUjBsQkJZd0ZBWUlLd1lCQlFVSEF3SUdDQ3NHQVFVRkJ3TUVNRFVHQTFVZEh3UXVNQ3d3S3FBb29DYUdKR2gwZEhCek9pOHZZM0pzTWk1bmMyVXVZMjl0TG1OdkwwTkJYMU5WUWpBeExtTnliREFkQmdOVkhRNEVGZ1FVaHU0emlnYWR2akxKdUdtVkdrbDI1SUMxbjVvd0RnWURWUjBQQVFIL0JBUURBZ1R3TUEwR0NTcUdTSWIzRFFFQkN3VUFBNElDQVFBRVBIQ0RMczFjaWphUEVFL0lOVTdyOTZRYk1YN0l1a3hLWitPMmxkYUZ6cGNrdHJrUjU1ZVpQWFBvQS95UVJhb0s0cEh2RjBUbzkxRnk3MHE0cENUV2lmV1h6ZDFrb050OVZTU1BGdG9LMkhSQ2x5YUt2aDJUT2dFYnJoU25aZ2k1MnphUzF2eUxqY1puQmxqZVc1M1RMbjcxUTRmWjdLRkMvcFpOTVN1dnI5a0FtUTB6SGpwMmYxY0hLRERtczNNS1FET015ZXpPZDVsN3plOWdPRVQrNy93eVZEUU1FOTRCc24vK0xEYWFjdmRrYXFHNjFqVExRS3dUSXd5WnNpbXlKcVplejNuR2xaSk1ZRFBEZE1lYjRKTDBHWlg5QjR0OGFINzFlbjNScTVkbllrS1FRNmpIeGl5YkdDOTFuY0kycnhvMUM4RlRmM1YyRmdpUkRiSFZxSzdHZFZNbHZMMlg4NUszTnVJblM0elQ3WjBOK0tydWdNWjZCQ3hTN0kwRDBqeC9vT0pvOFZVa3BjSDJ0YkpOTTBRcytZQU9qMkZFaTEyV3RyTHJkZlcyZE4vU0NBa2RBN1VPakZNQmVVUlh4OGVuMkZrcEg5NHJNNnJ2c1ZKWTR5NWhhY0JJYUJIMG9zenE4NGlXd2M4RDVQems5VkhGRjZkLzZJNlZRSkRKeXF0TGxySGVPNDFhbVR4ejczSEp4bk43OXRxdER3N1FvMHd4bWRIUjQrZVc0QUZYeUNjVUJ0TFhLSldQeUUwQTIrSlVOUWh0cnN6K1o1ZmJQRTRWdWZGUmJFZnA3WWpROFpybVgvb2w0U1JtVmxQeXltTXlhbEEwSWtoRkhxUjlhbG5mWVArOVpHSE50S2FoVlNFWnB6TXFlVDd5bmxxMG5mUlI0dTUxb2c9PTwvd3NzZTpCaW5hcnlTZWN1cml0eVRva2VuPjxkczpTaWduYXR1cmUgSWQ9IlNJRy05OEQwM0UzNjc2QkJEQzhGN0M3QTBDNzBGQkM5QzhFQzhBMDMyRDBEIiB4bWxuczpkcz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC8wOS94bWxkc2lnIyI+PGRzOlNpZ25lZEluZm8+PGRzOkNhbm9uaWNhbGl6YXRpb25NZXRob2QgQWxnb3JpdGhtPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzEwL3htbC1leGMtYzE0biMiPjxlYzpJbmNsdXNpdmVOYW1lc3BhY2VzIFByZWZpeExpc3Q9IndzYSBzb2FwIHdjZiIgeG1sbnM6ZWM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMTAveG1sLWV4Yy1jMTRuIyIvPjwvZHM6Q2Fub25pY2FsaXphdGlvbk1ldGhvZD48ZHM6U2lnbmF0dXJlTWV0aG9kIEFsZ29yaXRobT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS8wNC94bWxkc2lnLW1vcmUjcnNhLXNoYTI1NiIvPjxkczpSZWZlcmVuY2UgVVJJPSIjSUQtN0VBRTA3NTY3RDNERUEzMjQwMzIzRjQ2NzA4NzNEM0RCM0EzQ0NENyI+PGRzOlRyYW5zZm9ybXM+PGRzOlRyYW5zZm9ybSBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMTAveG1sLWV4Yy1jMTRuIyI+PGVjOkluY2x1c2l2ZU5hbWVzcGFjZXMgUHJlZml4TGlzdD0ic29hcCB3Y2YiIHhtbG5zOmVjPSJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzEwL3htbC1leGMtYzE0biMiLz48L2RzOlRyYW5zZm9ybT48L2RzOlRyYW5zZm9ybXM+PGRzOkRpZ2VzdE1ldGhvZCBBbGdvcml0aG09Imh0dHA6Ly93d3cudzMub3JnLzIwMDEvMDQveG1sZW5jI3NoYTI1NiIvPjxkczpEaWdlc3RWYWx1ZT42cDE0VHJZMHZwbWxpUmN1RGZlbzVqUG9zU2poZ0c2QnZBS0hLcjhubHFZPTwvZHM6RGlnZXN0VmFsdWU+PC9kczpSZWZlcmVuY2U+PC9kczpTaWduZWRJbmZvPjxkczpTaWduYXR1cmVWYWx1ZT5NNVRLYXFHQ0Z3aDYyMzNNSUFkVG92T2lYVmtuSkg0WGdBR3VhRDBSSFRBMHZOZnoxbWVoUzhzTW9SSWk1ZnVUcDhIOGFmdUF6Q3lHaWRMd0hWVG5xQ1pzUGNIVDdhalBMUUoyMVExZHhhTXB4dzNaQWxSRkNFUEFQUDRIVForR25jVkZMb0w1QTJNZWJYUHBLQzBaaUQrZEZCOU5zOStieFlRWnRIMlo1czFBVStYQm43RWYvZUpGNzBWdk5GZHBGYWhuM1JOMWs0S0I3M1ZiMm80WlIyNjErdkNkeEZhRy9oN3JaSi9tcnFHd0xuN3YrQ2Nha05Yb3VWcHhLY3h0QTJaVnlYb0ZPSWxCUFBSQzd2Z2dNTCtrSEc4WVBpT21yY283MzVhU2VOVEFnRlRmWUtUUFN5WEtRbitNaXh3c2Vvc1NQR0xocCtFZGhjUllnYzYzTVE9PTwvZHM6U2lnbmF0dXJlVmFsdWU+PGRzOktleUluZm8gSWQ9IktJLTZEMTA2NDZFRTVDMzFBQzkzRTg1RERFMjY2MTY3MjU2OUZDQUZBMDAiPjx3c3NlOlNlY3VyaXR5VG9rZW5SZWZlcmVuY2Ugd3N1OklkPSJTVFItMDlENkQ4MTFCQjU1NTBEODhGQTlENjY0RkRENDQzODA1NzUyMzRERiI+PHdzc2U6UmVmZXJlbmNlIFVSST0iI1RPUlJFU09GVFdBUkUtMTczNzE1QUY3MEY4ODk0NzJERENFODgzQjYxNUQ0RkE1Q0M0QzUyNyIgVmFsdWVUeXBlPSJodHRwOi8vZG9jcy5vYXNpcy1vcGVuLm9yZy93c3MvMjAwNC8wMS9vYXNpcy0yMDA0MDEtd3NzLXg1MDktdG9rZW4tcHJvZmlsZS0xLjAjWDUwOXYzIi8+PC93c3NlOlNlY3VyaXR5VG9rZW5SZWZlcmVuY2U+PC9kczpLZXlJbmZvPjwvZHM6U2lnbmF0dXJlPjwvd3NzZTpTZWN1cml0eT48d3NhOkFjdGlvbj5odHRwOi8vd2NmLmRpYW4uY29sb21iaWEvSVdjZkRpYW5DdXN0b21lclNlcnZpY2VzL0dldFN0YXR1c1ppcDwvd3NhOkFjdGlvbj48d3NhOlRvIHdzdTpJZD0iSUQtN0VBRTA3NTY3RDNERUEzMjQwMzIzRjQ2NzA4NzNEM0RCM0EzQ0NENyIgeG1sbnM6d3N1PSJodHRwOi8vZG9jcy5vYXNpcy1vcGVuLm9yZy93c3MvMjAwNC8wMS9vYXNpcy0yMDA0MDEtd3NzLXdzc2VjdXJpdHktdXRpbGl0eS0xLjAueHNkIj5odHRwczovL3ZwZmUtaGFiLmRpYW4uZ292LmNvL1djZkRpYW5DdXN0b21lclNlcnZpY2VzLnN2Yzwvd3NhOlRvPjwvc29hcDpIZWFkZXI+CiAgICA8c29hcDpCb2R5PgogICAgICAgIDx3Y2Y6R2V0U3RhdHVzWmlwPgogICAgICAgICAgICA8IS0tT3B0aW9uYWw6LS0+CiAgICAgICAgICAgIDx3Y2Y6dHJhY2tJZD5lM2U0YmIyYi05Y2IzLTQzZWUtODA3Ny1kNWVlNzA0ZjkyYmE8L3djZjp0cmFja0lkPgogICAgICAgIDwvd2NmOkdldFN0YXR1c1ppcD4KICAgIDwvc29hcDpCb2R5Pgo8L3NvYXA6RW52ZWxvcGU+Cg==",
"rptazip": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3d3dy53My5vcmcvMjAwMy8wNS9zb2FwLWVudmVsb3BlIiB4bWxuczphPSJodHRwOi8vd3d3LnczLm9yZy8yMDA1LzA4L2FkZHJlc3NpbmciIHhtbG5zOnU9Imh0dHA6Ly9kb2NzLm9hc2lzLW9wZW4ub3JnL3dzcy8yMDA0LzAxL29hc2lzLTIwMDQwMS13c3Mtd3NzZWN1cml0eS11dGlsaXR5LTEuMC54c2QiPjxzOkhlYWRlcj48YTpBY3Rpb24gczptdXN0VW5kZXJzdGFuZD0iMSI+aHR0cDovL3djZi5kaWFuLmNvbG9tYmlhL0lXY2ZEaWFuQ3VzdG9tZXJTZXJ2aWNlcy9HZXRTdGF0dXNaaXBSZXNwb25zZTwvYTpBY3Rpb24+PG86U2VjdXJpdHkgczptdXN0VW5kZXJzdGFuZD0iMSIgeG1sbnM6bz0iaHR0cDovL2RvY3Mub2FzaXMtb3Blbi5vcmcvd3NzLzIwMDQvMDEvb2FzaXMtMjAwNDAxLXdzcy13c3NlY3VyaXR5LXNlY2V4dC0xLjAueHNkIj48dTpUaW1lc3RhbXAgdTpJZD0iXzAiPjx1OkNyZWF0ZWQ+MjAyMS0xMi0xMVQyMjo0MTo1NS40NDVaPC91OkNyZWF0ZWQ+PHU6RXhwaXJlcz4yMDIxLTEyLTExVDIyOjQ2OjU1LjQ0NVo8L3U6RXhwaXJlcz48L3U6VGltZXN0YW1wPjwvbzpTZWN1cml0eT48L3M6SGVhZGVyPjxzOkJvZHk+PEdldFN0YXR1c1ppcFJlc3BvbnNlIHhtbG5zPSJodHRwOi8vd2NmLmRpYW4uY29sb21iaWEiPjxHZXRTdGF0dXNaaXBSZXN1bHQgeG1sbnM6Yj0iaHR0cDovL3NjaGVtYXMuZGF0YWNvbnRyYWN0Lm9yZy8yMDA0LzA3L0RpYW5SZXNwb25zZSIgeG1sbnM6aT0iaHR0cDovL3d3dy53My5vcmcvMjAwMS9YTUxTY2hlbWEtaW5zdGFuY2UiPjxiOkRpYW5SZXNwb25zZT48YjpFcnJvck1lc3NhZ2UgaTpuaWw9InRydWUiIHhtbG5zOmM9Imh0dHA6Ly9zY2hlbWFzLm1pY3Jvc29mdC5jb20vMjAwMy8xMC9TZXJpYWxpemF0aW9uL0FycmF5cyIvPjxiOklzVmFsaWQ+ZmFsc2U8L2I6SXNWYWxpZD48YjpTdGF0dXNDb2RlPjI8L2I6U3RhdHVzQ29kZT48YjpTdGF0dXNEZXNjcmlwdGlvbj5TZXQgZGUgcHJ1ZWJhIGNvbiBpZGVudGlmaWNhZG9yICBhMmZkZTA1OS1lM2FlLTQ2ZmYtOGE2My01NWJhNTBmOThlZTQgZXMgaW5jb3JyZWN0by48L2I6U3RhdHVzRGVzY3JpcHRpb24+PGI6U3RhdHVzTWVzc2FnZSBpOm5pbD0idHJ1ZSIvPjxiOlhtbEJhc2U2NEJ5dGVzIGk6bmlsPSJ0cnVlIi8+PGI6WG1sQnl0ZXMgaTpuaWw9InRydWUiLz48YjpYbWxEb2N1bWVudEtleSBpOm5pbD0idHJ1ZSIvPjxiOlhtbEZpbGVOYW1lIGk6bmlsPSJ0cnVlIi8+PC9iOkRpYW5SZXNwb25zZT48L0dldFN0YXR1c1ppcFJlc3VsdD48L0dldFN0YXR1c1ppcFJlc3BvbnNlPjwvczpCb2R5PjwvczpFbnZlbG9wZT4=",
"attacheddocument": ""
}
Estado del documento by CUFE
:
POST
/api/ubl2.1/status/document/cufe
El CUFE es el código alfanumerico que contiene el documento a consultar (contiene 96 caracteres)
Permite consultar estado del documento y enviar una copia del ZipAtachedDocument al email del cliente. Funciona en ambiente de prueba y de producción.Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
Si la propiedad sendmail es true, se enviará una copia del ZipAtachedDocument al email del cliente, la siguiente propiedad permite cambiar el nombre por defecto al archivo a enviar.
{
"sendmail": false,
"atacheddocument_name_prefix": ""
}
Response in status 200
Deberá validar estas propiedades (IsValid, StatusCode y StatusDescription) las cuales brinda información del documento enviado.
{
"message": "Consulta generada con éxito",
"ResponseDian": {
"Envelope": {
"Header": {
"Action": {
"_attributes": {
"mustUnderstand": "1"
},
"_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/GetStatusResponse"
},
"Security": {
"_attributes": {
"mustUnderstand": "1"
},
"Timestamp": {
"_attributes": {
"Id": "_0"
},
"Created": "2021-12-11T23:30:09.782Z",
"Expires": "2021-12-11T23:35:09.782Z"
}
}
},
"Body": {
"GetStatusResponse": {
"GetStatusResult": {
"ErrorMessage": {},
"IsValid": "true",
"StatusCode": "00",
"StatusDescription": "Procesado Correctamente.",
"StatusMessage": "La Factura electrónica FE1, ha sido autorizada.",
"XmlBase64Bytes": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiIHN0YW5kYWxvbmU9Im5vIj8",
"XmlBytes": {
"_attributes": {
"nil": "true"
}
},
"XmlDocumentKey": "bd5b01232189c98dd4f96609f73af85988f61239cb2093944bfcf0c6bf31d0b7df8770a292ca4f25277607bac1adc3283",
"XmlFileName": "fv09012492320002100000001"
}
}
}
}
},
"reqzip": "PD94bWwgdmVyc2lvbj0iMS4wIj8+Cjxzb2FwOkVudmVsb3BlIHhtbG5zOnNvYXA9Imh0dHA6Ly93d3cudzMub3JnLzIwMDMvMDUvc29hcC1lbnZlbG9wZSIgeG1sbnM6d2NmPSJodHRwOi8vd2NmLmRpYW4uY29sb21iaW",
"rptazip": "PHM6RW52ZWxvcGUgeG1sbnM6cz0iaHR0cDovL3d3dy53My5vcmcvMjAwMy8wNS9zb2FwLWVudmVsb3BlIiB4bWxuczphPSJodHRwOi8vd3d3LnczLm9yZy8yMDA1LzA4L2FkZHJlc3NpbmciIHhtbG5zOnU9Imh0dHA6L",
"attacheddocument": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiIHN0YW5kYWxvbmU9Im5vIj8+CjxBdHRhY2hlZERvY3VtZW50IHhtbG5zOmRzPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwLzA5L3htbGRzaWcj",
"cufecude": "bd5b01232189c98dd4f96609f73af85988f61239cb2093944bfcf0c6bf31d0b7df8770a292ca4f25277607bac1adc3283"
}
Paso a Producción
Paso a Producción
:
PUT
/api/ubl2.1/config/environment
El ZipKey es retornado por el servicio de envio de documentos en el ambiente de prueba y tiene la siguiente forma: e3e4bb2b-9cb3-43ee-8077-d5ee704f92ba
En el ambiente de producción se retorna directamente el error y no es necesario realizar una segunda consulta!Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
Estas propiedades son opcionales en el body de la petición.
{
"type_environment_id": 1
}
Response in status 200
Deberá validar estas propiedades (IsValid, StatusCode y StatusDescription) las cuales brinda información del documento enviado.
{
"message": "Ambiente actualizado con éxito",
"company": {
"id": 1,
"user_id": 1,
"identification_number": "901249232",
"dv": "5",
"language_id": 79,
"tax_id": 1,
"type_environment_id": 1,
"type_operation_id": 10,
"type_document_identification_id": 3,
"country_id": 46,
"type_currency_id": 35,
"type_organization_id": 2,
"type_regime_id": 1,
"type_liability_id": 117,
"municipality_id": 439,
"merchant_registration": "0000000-00",
"address": "CLLA 18A # 11 - 20,
"phone": "3106031839",
"created_at": "2021-07-14 18:41:54",
"updated_at": "2021-07-14 18:50:19",
"user": {
"id": 1,
"name": "NOMBRE EMPRESA",
"email": "cliente_api@dominio.com",
"email_verified_at": null,
"created_at": "2021-07-14 18:41:54",
"updated_at": "2021-07-14 18:41:54",
"id_administrator": null
},
"send": [
{
"id": 211,
"year": 2021,
"next_consecutive": 9,
"created_at": "2021-07-14 18:46:00",
"updated_at": "2021-07-14 18:46:47"
},
{
"id": 213,
"year": 2021,
"next_consecutive": 2,
"created_at": "2021-07-14 18:47:35",
"updated_at": "2021-07-14 18:47:35"
},
{
"id": 214,
"year": 2021,
"next_consecutive": 2,
"created_at": "2021-07-14 18:47:37",
"updated_at": "2021-07-14 18:47:37"
},
{
"id": 212,
"year": 2021,
"next_consecutive": 11,
"created_at": "2021-07-14 18:46:00",
"updated_at": "2021-07-14 18:47:37"
}
]
}
}
Consultar resoluciónes activas (en DIAN)
:
POST
/api/ubl2.1/numbering-range
Headers
Content-Type: "application/json"
Authorization (Bearer TOKEN): "f4cc03f8ede50a53e32d74a500d4c71062e3621973645f07fc0adc55dff0297b"
Request
{
"Nit": "901249232",
"IDSoftware": "a5c5fd4e-6910-4e36-b618-05eb6c762ff2"
}
Response in status 200
Deberá validar estas propiedades (OperationCode, OperationDescription y ResponseList)
{
"message": "Consulta generada con éxito",
"ResponseDian": {
"Envelope": {
"Header": {
"Action": {
"_attributes": {
"mustUnderstand": "1"
},
"_value": "http://wcf.dian.colombia/IWcfDianCustomerServices/GetNumberingRangeResponse"
},
"Security": {
"_attributes": {
"mustUnderstand": "1"
},
"Timestamp": {
"_attributes": {
"Id": "_0"
},
"Created": "2021-07-14T23:50:33.984Z",
"Expires": "2021-07-14T23:55:33.984Z"
}
}
},
"Body": {
"GetNumberingRangeResponse": {
"GetNumberingRangeResult": {
"OperationCode": "100",
"OperationDescription": "Acción completada OK.",
"ResponseList": {
"NumberRangeResponse": {
"ResolutionNumber": "18764012354442",
"ResolutionDate": "2021-04-14",
"Prefix": "FE",
"FromNumber": "1",
"ToNumber": "1000",
"ValidDateFrom": "2021-04-14",
"ValidDateTo": "2021-10-14",
"TechnicalKey": "1e6c7d8d1d6655a3d1ff81867f40c8ef85cbf89a60dd076a317eb39ad02cb8bd"
}
}
}
}
}
}
}
}