Endpoints

A continuación se presentan los distintos endpoints disponibles según el tipo de evento:

📤 Emisión

Endpoints Nota Crédito

• POST ip:puerto/crear/notacredito/online

• POST ip:puerto/crear/notacredito/lote

Endpoints Nota Débito

• POST ip:puerto/crear/notadebito/online

• POST ip:puerto/crear/notadebito/lote

Estructura del body

{
    // Código de autorización interacción con los endpoints
    "authorization" : "" (string),
    // Usuario que efectua la creación del documento
    "usuario"       : "" (string),
    // Devolver el QR del enlace en base64 (png)
    "returnQr"      : false (boolean),
    // El contenido del documento a crear
    "documento"     : {} (array),
}

La plataforma ya cuenta con el desarrollo necesario para la emisión de estos documentos de forma sincrónica (envíos individuales "online"). Pero debido a imposiciones de la DNIT (ex SET), solamente ciertos contribuyentes pueden realizar emisiones por este método, por lo que de forma general se encuentra disponible las emisiones a través del metodo asincrónico (por lote).

❌ Anulación

Endpoints Nota Crédito

• POST ip:puerto/anular/notacredito

Endpoints Nota Débito

• POST ip:puerto/anular/notadebito

Estructura del body

{
    // Código de autorización interacción con los endpoints
    "authorization" : "" (string),
    // El CDC del documento por anular
    "cdc"           : "" (int),
    // Usuario que efectua la anulación del documento
    "usuario"       : "" (string),
    // El motivo de anulación del documento
    "motivo"        : "" (string)
}

Este endpoint funciona de forma sincrónica con la SIFEN, en caso presentarse intermitencias de parte de ellos, se retornará un mensaje de error y no se registrará el evento en ReKU, así también el estado será false.

❌ Inutilización

Endpoints Nota Crédito

• POST ip:puerto/inutilizar/notacredito

Endpoints Nota Débito

• POST ip:puerto/inutilizar/notadebito

Estructura del body

{
    // Código de autorización interacción con los endpoints
    "authorization"    : "" (string),
    // Usuario que efectua la inutilización del documento
    "usuario"          : "" (string),
    // El motivo de inutilización del documento
    "motivo"           : "" (string),
    // El número de establecimiento (sucursal)
    "establecimiento"  : "" (int),
    // El número de caja
    "caja"             : "" (int),
    // El número de documento
    "documento"        : "" (int)
}

Este endpoint funciona de forma sincrónica con la SIFEN, en caso presentarse intermitencias de parte de ellos, se retornará un mensaje de error y no se registrará el evento en ReKU, así también el estado será false.

Eliminación (interno)

Al utilizar el envío por lote, en caso de presentarse un inconveniente en la plataforma de facturación y no fue registrado correctamente pero, se constata su registro en ReKU, tienes un plazo de 10 minutos para eliminar el documento de la cola de procesado antes de que sea incluído en un lote para su envío a la SIFEN.

Endpoints Nota Crédito

• POST ip:puerto/eliminar/notacredito

Endpoints Nota Débito

• POST ip:puerto/eliminar/notadebito

Estructura del body

{
    // El número de establecimiento (sucursal)
    "establecimiento" : "" (int),
    // El número de caja
    "caja"            : "" (int),
    // El número de documento
    "documento"       : "" (int)
}