Firmado electrónica en documentos XML

Qué es la firma electrónica

La firma electrónica es un mecanismo que permite identificar al autor de un documento electrónico y garantizar que el contenido del mismo no ha sido alterado desde su creación. En el caso de la facturación electrónica, la firma electrónica se utiliza para validar la autenticidad e integridad de la factura. Esto es especialmente importante para garantizar la validez legal de la factura y evitar cualquier posible falsificación o alteración del documento. Además, la firma electrónica permite automatizar el proceso de validación de la factura, lo que simplifica el proceso de contabilidad y gestión de las facturas en general. Como desarrollador, entender la utilidad de la firma electrónica te permitirá crear aplicaciones que puedan validar de manera automática y confiable la autenticidad e integridad de las facturas electrónicas.

Firmado de documentos

Para poder firmar documentos XML es necesario haber registrado una firma con Grupo CDS, ésto se realiza mediante el contacto con un agente de ventas. Aunque es posible utilizar las firmas de pruebas de las cuales disponemos dentro de nuestro entorno de desarrollo.

POST •••/v1.0/signature

Petición para aplicar la firma del Emisor.

Se debe enviar un JSON indicando el NIT Emisor (nit_transmitter) y el DTE en Base64 (xml_dte).

Request

Header

Key	Value	Description
apiKey	{{apiKey}}	Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "xml_dte": ""
    }
}

Examples:

Example: Firmar

POST •••/v1.0/signature

Request

Header

Key	Value	Description
apiKey	{{apiKey}}	Llave que se brinda para acceder a este servicio.

Body

{
    "dte": {
        "nit_transmitter": "{{NIT Emisor}}",
        "xml_dte": ""
    }
}

Response

Body

{
  "xmlSigned": ""
}