Documentación Integración habbiles
    • Generación Factura Electrónica
      POST
    • Habilitación Factura Electrónica
      POST
    • Generación Nomina
      POST
    • Nomina habilitación
      POST
    • Obtener Numeración
      GET
    • Guardar Numeración
      POST
    • Obtener Recepciones
      GET
    • Generación Documento Equivalente POS (Archivo)
      POST
    • Generación Documento Equivalente POS (Body)
      POST
    • Habilitación Documento Equivalente POS
      POST
    • Generación Documento Soporte
      POST
    • Generación Nota Documento Soporte
      POST
    • Schemas
      • Petición Generación FE, NC, ND
      • Response General
      • NominaElectronica
      • Nómina de Eliminación
      • Nómina de Ajuste
      • GetNumeracion
      • Documentos Recibidos
      • Response POS
      • Petición POS Body
      • Documento Equivalente POS (estructura ERP)
      • Petición Documento Soporte

      Habilitación Factura Electrónica

      POST
      /HabDianTest/process-hab
      Factura ElectronicaHabilitaciónFE
      Última modificación:2026-07-31 14:13:44
      Ejecuta el proceso de habilitación de tu compañía ante la DIAN. El servicio realiza el envío
      de habilitación correspondiente y devuelve el resultado, indicando si la compañía quedó
      habilitada.
      Autenticación por API Key: envía tu x-api-key y el x-company-id de la compañía en los headers.

      Método y ruta#

      POST /HabDianTest/process-hab

      Headers#

      HeaderTipoRequeridoDescripción
      x-api-keystringSíClave de acceso (API Key) de tu compañía.
      x-company-idintegerSíIdentificador de la compañía.
      Content-TypestringNoapplication/json si envías cuerpo.

      Query params#

      ParamTipoRequeridoDescripción
      test-idstringNoIdentificador del set de pruebas asignado por la DIAN.

      Body#

      Opcional. No es necesario para ejecutar la habilitación.

      Respuesta#

      CampoTipoDescripción
      Errorsarray<string>Mensajes de error cuando la habilitación no fue exitosa.
      IsValidbooleantrue si la compañía quedó habilitada.
      ResultCodeintegerCódigo de resultado (ver tabla).
      Warningarray<string>Advertencias no bloqueantes.
      ResultDatastringMensaje descriptivo del resultado.

      Códigos de resultado#

      ResultCodeHTTPIsValidSignificado
      200200trueCompañía habilitada correctamente (o ya habilitada previamente).
      304200falseEl proceso finalizó sin lograr la habilitación.
      401200falseCredenciales inválidas.
      500500falseError al procesar la habilitación.

      Solicitud

      Parámetros de consulta

      Parámetros de Header

      Respuestas

      🟢200Éxito
      application/json
      Bodyapplication/json

      🟠400Error
      Solicitud Ejemplo de Solicitud
      Shell
      JavaScript
      Java
      Swift
      curl --location --globoff --request POST 'https://{{ur_basel}}/HabDianTest/process-hab?test-id={{test-id}}' \
      --header 'x-api-key: {{api_key}}' \
      --header 'x-company-id: {{company_id}}'
      Respuesta Ejemplo de Respuesta
      200 - Ejemplo Exito
      {
          "Errors": [],
          "IsValid": true,
          "ResultCode": 200,
          "Warning": [],
          "ResultData": "Procesado Correctamente."
      }
      Modificado en 2026-07-31 14:13:44
      Anterior
      Generación Factura Electrónica
      Siguiente
      Generación Nomina
      Built with