Documentación – XML

En los siguientes pasos, te guiaremos a través del proceso de integración y uso de nuestra API para el envío de facturas electrónicas a la DIAN en formato XML.

Requisitos:

  1. Registrar Software Propio en la DIAN
  2. Contar con un certificado digital
  3. Contar con una API KEY

API:

url: http://demo.enlote.co

Nota: Para acceder a la API On-Premise, es necesario completar con éxito las pruebas en la nube y demostrar un dominio básico del funcionamiento de la API. De esta manera, garantizamos que la instalación y configuración de la API On-Premise se realice de forma correcta y eficiente.

Creación de empresas

Este servicio web permite la creación de empresas en el sistema, lo cual es un paso previo necesario para la posterior transmisión de documentos electrónicos a la DIAN.

Metodo URL Tipo
POST /api/v1/empresa Creación
PUT /api/v1/empresa Actualización

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON Descripción Tipo de dato Notas
tipo_organizacion Identifica el tipo de organización. Numérico 1: Persona Jurídica y asimiladas
2: Persona Natural y asimiladas
digito_verificacion Dígito de verificación del NIT. Numérico
nombre.nombre_comercial Nombre comercial de la empresa. Cadena de texto
nombre.razon_social Razón social de la empresa. Cadena de texto
telefono Número de teléfono de la empresa. Cadena de texto
direccion Dirección física de la empresa. Cadena de texto
municipio Código DANE del municipio de la empresa. Numérico
departamento Código DANE del departamento de la empresa. Numérico
identificacion Número de identificación tributaria (NIT) de la empresa. Numérico
regimen_fiscal Código del régimen fiscal al que pertenece la empresa. Numérico 48: Régimen Simplificado
responsabilidades_fiscales Responsabilidades fiscales de la empresa. Cadena de texto R-99-PN: Régimen Simplificado
correo_electronico Correo electrónico de contacto de la empresa. Cadena de texto
tipo_identificacion Código del tipo de identificación de la empresa. Numérico 31: NIT

Ejemplo

{
    "tipo_organizacion": 1,
    "digito_verificacion": 1,
    "nombre": {
      "nombre_comercial": "Empresa A",
      "razon_social": "Empresa A"
    },
    "telefono": "2424",
    "direccion": "CL 345 3",
    "municipio": "05001",
    "departamento": "05",
    "identificacion": "2222222",
    "regimen_fiscal": 48,
    "responsabilidades_fiscales": "R-99-PN",
    "correo_electronico": "a@municipio.com",
    "tipo_identificacion": "31"
  }

Creación de Certificado

Este servicio web permite registrar los certificados PFX en formato base64 para cada empresa, junto con su clave correspondiente. Los certificados PFX son necesarios para la firma digital de los documentos electrónicos que se envían a la DIAN, asegurando la autenticidad e integridad de la información.

Metodo URL Tipo
POST /api/v1/certificado Creación
PUT /api/v1/certificado Actualización

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON Descripción Tipo de dato Notas
empresa Número de identificación tributaria (NIT) de la empresa. Cadena de texto
clave_certificado Dígito de verificación del NIT. Cadena de texto
certificado Certificado codificado en formato base64. Cadena de texto

Ejemplo

{
    "empresa": "222222",
    "clave_certificado": "1234",
    "certificado": "MIACAQM..."
    
  }

Transmitir Documento XML

Este servicio web es fundamental para la gestión de facturación electrónica, ya que permite la transmisión de archivos XML, como facturas, notas de crédito y notas de débito, a la DIAN. El servicio se encarga de recibir el archivo XML en formato base64, firmarlo digitalmente con el certificado PFX de la empresa emisora, empaquetarlo en un archivo ZIP y finalmente enviarlo a la DIAN de manera segura.

Metodo URL Tipo
POST /api/v1/documento/transmitir/xml Creación

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON Descripción Tipo de dato Notas
identificacion_software Identificación del Software Propio Cadena de texto
pin_software PIN del Software Propio. Cadena de texto
ambiente Tipo de ambiente. Númerico 1: Producción
2: Pruebas
clave_tecnica Clave tecnica del rango de numeración asociado. Cadena de texto
xml Documento XML codificado en formato base64. Cadena de texto

Ejemplo

{
    "identificacion_software": "345345-2342-2344-g344-345dsf5as",
    "pin_software": "",
    "ambiente": 2,
    "clave_tecnica": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
    "xml":"PD94bW..."
  }

Consultar Estado Documento XML

Metodo URL Tipo
GET /api/v1/documento/estado Consulta

Headers

Content-Type:application/json

X-API-KEY: API KEY

Cuerpo

Campo JSON Descripción Tipo de dato Notas
identificacion_software Identificación del Software Propio Cadena de texto
empresa Número de identificación tributaria (NIT) de la empresa. Cadena de texto
ambiente Tipo de ambiente. Númerico 1: Producción
2: Pruebas
identificador CUFE o CUDE del documento a consultar. Cadena de texto

Ejemplo

{
    "identificacion_software": "345345-2342-2344-g344-345dsf5as",
    "empresa": "234423423",
    "identificador": "465becc...",
    "ambiente": 2
  }