Certificación de DTE#

POST •••/v1.0/dte

Petición para Certificar un DTE que ya tiene aplicada la firma del Emisor.

Se debe enviar un JSON indicando el NIT Emisor (nit_transmitter), Serie y Numero internos (controlados por el sistema del Emisor), y el DTE en Base64 (xml_dte) ya Firmado por el Emisor.

Peticion#

Header

Key

Valor

Descripción

apiKey

{{apiKey}}

Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "serie": "A",
        "number": 2,
        "xml_dte": ""
    }
}

Ejemplos:#

Ejemplo: Certificar OK

POST •••/v1.0/dte

Peticion

Header

Key

Valor

Descripción

apiKey

{{apiKey}}

Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "serie": "A",
        "number": 1,
        "xml_dte": ""
    }
}

Respuesta

Body

{
  "dateCert": 1675876954132,
  "status": "ok",
  "serie": "A0509985",
  "number": "2064666590",
  "uuid": "A0509985-7B10-4FDE-8AF1-2DDE8528FF64",
  "xmlSigned": "",
  "rules": [
    {
      "description": "Validación 2.2.2.1 NIT del Emisor: El NIT no existe en el RTU (sistema electrónico de la SAT que contiene el Registro Tributario Unificado).",
      "date": 1675876954036,
      "step": "2.2.2.1",
      "error": "",
      "pass": true
    },
    {
      "description": "Validación 2.2.2.2 NIT del Emisor: El NIT no tiene estatus activo en el RTU (sistema electrónico de la SAT que contiene el Registro Tributario Unificado).",
      "date": 1675876954036,
      "step": "2.2.2.2",
      "error": "",
      "pass": true
    },
    {
      "description": "Validación 2.2.2.3 NIT del Emisor: El contenido de la casilla correspondea un NIT que no está afiliado al IVA (la afiliación puede ser en cualquierregimén) y el tipo de DTE es distinto de: 'CIVA'.",
      "date": 1675876954038,
      "step": "2.2.2.3",
      "error": "",
      "pass": true
    }
  ]
}

Ejemplo: Certificar - Fallida 1

POST •••/v1.0/dte

Peticion

Header

Key

Valor

Descripción

apiKey

{{apiKey}}

Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "serie": "A",
        "number": 2,
        "xml_dte": ""
    }
}

Respuesta

Body

{
  "code": "2.2.4.4",
  "message": "El NIT del Receptor es inválido. ",
  "error": {
    "dteId": "63e3e4f5e6d425533ce42e70",
    "rules": [
      {
        "description": "Validación 2.2.2.1 NIT del Emisor: El NIT no existe en el RTU (sistema electrónico de la SAT que contiene el Registro Tributario Unificado).",
        "date": 1675879669206,
        "step": "2.2.2.1",
        "error": "",
        "pass": true
      },
      {
        "description": "Validación 2.2.2.2 NIT del Emisor: El NIT no tiene estatus activo en el RTU (sistema electrónico de la SAT que contiene el Registro Tributario Unificado).",
        "date": 1675879669206,
        "step": "2.2.2.2",
        "error": "",
        "pass": true
      },
      {
        "description": "Validación 2.2.2.3 NIT del Emisor: El contenido de la casilla correspondea un NIT que no está afiliado al IVA (la afiliación puede ser en cualquierregimén) y el tipo de DTE es distinto de: 'CIVA'.",
        "date": 1675879669208,
        "step": "2.2.2.3",
        "error": "",
        "pass": true
      },
      {
        "description": "Validación 2.2.1.1 Fecha y hora de emisión: El día, mes y año de la casilla 'Fecha y hora de emisión' tiene una antigüedad mayor a cinco días con respecto al día, mes y año de la casilla 'Fecha y hora de certificación' (Se cuenta a partir del siguiente día de la emisión).",
        "date": 1675879669208,
        "step": "2.2.1.1",
        "error": "",
        "pass": true
      },
      {
        "description": "Validación 2.2.3.1 Código de Establecimiento: El establecimiento no aparece activo en la SAT para ese NIT en esa fecha de emisión.",
        "date": 1675879669210,
        "step": "2.2.3.1",
        "error": "",
        "pass": true
      },
      {
        "description": "Validación 2.2.4.4 No se incluye la casilla 'Tipo Especial' y el contenido de la casilla 'ID del Receptor' es diferente de 'CF' y no existe en el RTU",
        "date": 1675879669210,
        "step": "2.2.4.4",
        "error": "El NIT del Receptor es inválido.",
        "pass": false
      }
    ]
  }
}

Ejemplo: Certificar - Fallida 2 - refID

POST •••/v1.0/dte

Peticion

Header

Key

Valor

Descripción

apiKey

{{apiKey}}

Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "serie": "A",
        "number": 1,
        "xml_dte": ""
    }
}

Respuesta

Body

{
  "code": "400",
  "message": "DTE CON ESTE NIT, ESTABLECIMIENTO, SERIE Y NUMERO ENVIADO ANTERIORMENTE",
  "error": {},
  "refID": "63e3da5ae6d425533ce42e6c"
}