Antes de iniciar, es importante tener en cuenta que existen dos tipos de compañías en la API:

• Principal (main)
• Asociada (associated)

Cuando generamos el token, se asocia a éste la compañía "Principal" que puede ser o no una de las empresas emisoras de documentos. Es por esto, que tenemos disponibles una serie de servicios, donde podrá gestionar aquellas compañías de tipo "Asociada", las cuales serán aquellas empresas emisoras de documentos electrónicos asociadas a su token.

✔️ Paso 1 - Crear compañía

Se deben indicar los datos de una compañía previamente registrada en la Entidad (DIAN), si por el momento no tiene estos datos puede hacer uso de los datos que componen los ejemplos.

La creación de la compañía se realiza por medio del servicio createcompany

{
    "name": "Mi Compañía S.A.S",
    "identification": "900559088",
    "dv": "2",
    "useAlegraCertificate": true
}

✔️ Paso 2 - Habilitar la compañía en la DIAN y en la API

Consiste en enviar un conjunto de documentos de prueba (Set de pruebas) requeridos por la entidad por medio del servicio createtestset.

📘

En el ambiente sandbox, se debe indicar el Government Id a70562e0-631e-4ceb-aa65-36887b57dc17. En el ambiente productivo, se debe indicar exactamente el código que genere la entidad.

Es importante especificar el tipo (type) de set de pruebas correspondiente:

• invoices: Habilitar la compañía para la emisión de Facturas Electrónicas
• payrolls: Habilitar la compañía para la emisión de Nóminas Electrónicas
• pos: Habilitar la compañía para la emisión de Documentos Equivalentes POS

{
    "type": "invoices",
    "governmentId": "a70562e0-631e-4ceb-aa65-36887b57dc17",
    "company": {
        "id": "XXXXXXXXXXXXXXXXXXXXX"
    }
}

✔️ Paso 3 - Emisión de Documentos

🚧

Este ejemplo aplica únicamente para la emisión de Facturas Electrónicas.

En este paso, ya es posible iniciar con la emisión de documentos. Aquí, se debe tener presente que cuando se registra una compañía en la DIAN, la entidad genera una numeración de pruebas, la cual se debe indicar en el objeto "resolution" del request. Si la compañía emisora se dió de alta con información contenida en el paso 1, debes utilizar la información de ejemplo (secciones "resolution" y "company" del request) propuesta en el servicio createinvoice.

"resolution": {
    "resolutionNumber": "18760000001",
    "prefix": "SETP",
    "minNumber": 990000000,
    "maxNumber": 995000000,
    "startDate": "2019-01-19",
    "endDate": "2030-01-19",
    "technicalKey": "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c"
},
"company": {
    "address": {
      "address": "Cra. 13 #12-12 Edificio A & A",
      "city": "11001",
      "department": "11",
      "country": "CO"
    },
    "id": "01FCYA9GSSNT2674KGJV2V0NS9",
    "organizationType": 1,
    "identificationType": "31",
    "identificationNumber": "900559088",
    "dv": "2",
    "name": "Soluciones Alegra S.A.S",
    "regimeCode": "R-99-PN",
    "email": "[email protected]"
}

📘

Nota

Para emitir documentos en ambiente de producción, cada compañía debe generar una Resolución Electrónica (Rango de Numeración) directamente en la entidad y comunicarlo en el request, especificamente en el objeto "resolution".

Este listado de Rangos de Numeración pueden ser consultados por medio del endpoint getresolutions

Si deseas conocer más acerca del proceso de configuración y habilitación en la DIAN, haz click aquí.