1. Registro de Empresas y Certificados

En este tutorial, te guiaremos paso a paso en el proceso de registro de tu empresa y realización del set de pruebas en la plataforma de la DIAN. Este proceso te permitirá familiarizarte con la plataforma y asegurarte de que estás listo para emitir facturas electrónicas de manera oficial.

Requisitos

Para comenzar, es imprescindible contar con un certificado digital de facturación electrónica asociado a la empresa con la que realizarás las pruebas. Este certificado se puede obtener a través de una de las siguientes plataformas:

Certificado de pruebas

En caso de que no dispongas de un certificado digital, te ofrecemos la posibilidad de realizar pruebas utilizando nuestro certificado de pruebas. Es importante tener en cuenta que este certificado está destinado exclusivamente para pruebas locales y no está habilitado para la emisión de facturas electrónicas.

Descargar Certificado

Contraseña: 123456

Registrar Software Propio

Para obtener la identificación y el rango de prueba es necesario registrarse como software propio en la plataforma de la DIAN.

Sigue este video para aprender como hacerlo:

Video

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 
{
    "empresa": "222222",
    "clave_certificado": "1234",
    "certificado": "MIACAQM..."
}