Consultar tipificación del cliente

Devuelve qué campos del body de /recaudo puede usar el cliente identificado por nit (y id_cliente en headers). Indica si la guía se identifica por codigoRemision, referencia, referenciaDetalle o combinaciones.

GET /orquestador/tipificacion v3.2.0
Autenticación
Bearer Token
Ambiente
API Gateway — entorno de pruebas (integración externa / Suite)

Descripción

Devuelve qué campos del body de /recaudo puede usar el cliente identificado por nit (y id_cliente en headers). Indica si la guía se identifica por codigoRemision, referencia, referenciaDetalle o combinaciones.

Nota: Suite Logística usa tipificación fija interna; este endpoint está orientado a clientes externos.

Quick Start

  1. Obtén tus credenciales de acceso (Bearer Token).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

GET /orquestador/tipificacion

Base URL https://api-test.coordinadora.tech/suite/guias

Parámetros

Sin parámetros declarados.

Respuesta

200
Tipificación encontrada o data: null si no hay registro.
{
    "isError": false,
    "data": {
        "nitCliente": "901411985",
        "nombreCliente": "Dropi S.A.S",
        "referencia": false,
        "referenciaDetalle": false,
        "codigoRemision": true
    },
    "timestamp": "2026-07-06T22:15:00.000Z",
    "id": "e1f2a3b4c5d6e7f8091a2b3c4d5e6f7a8b9c0d1"
}

Ejemplo de respuesta

200 Tipificación encontrada o `data: null` si no hay registro. 
{
    "isError": false,
    "data": {
        "nitCliente": "901411985",
        "nombreCliente": "Dropi S.A.S",
        "referencia": false,
        "referenciaDetalle": false,
        "codigoRemision": true
    },
    "timestamp": "2026-07-06T22:15:00.000Z",
    "id": "e1f2a3b4c5d6e7f8091a2b3c4d5e6f7a8b9c0d1"
}

Errores

400
Cabeceras inválidas
{
    "isError": true,
    "message": "Invalid input: expected string, received undefined",
    "code": "BAD_MESSAGE",
    "timestamp": "2026-07-06 17:16:10",
    "statusCode": 400,
    "id": "c5d6e7f8091a2b3c4d5e6f7a8b9c0d1e2f3a4b5"
}
403
Token inválido o sin permisos
RBAC: access denied
500
Error interno
[]