Consultar existencia de etiquetas 1D/2D

Validación Zod estricta: cada elemento de unidades debe ser solo dígitos y longitud 15 (1D) u 32 (2D). Si falla, 400 con BAD_MESSAGE y el texto de validación (p. ej. longitud o caracteres no numéricos). Respuesta exitosa envuelta en Result con data array o vacío.

POST /existe v2.13.9
Autenticación
Bearer Token
Ambiente
Entorno de pruebas

Descripción

Validación Zod estricta: cada elemento de unidades debe ser solo dígitos y longitud 15 (1D) u 32 (2D). Si falla, 400 con BAD_MESSAGE y el texto de validación (p. ej. longitud o caracteres no numéricos). Respuesta exitosa envuelta en Result con data array o vacío.

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

POST /existe

Base URL https://etiquetas-service-test.coordinadora.com/etiquetas

Parámetros

Sin parámetros declarados.

Body *

{
    "$ref": "#/components/schemas/ExisteEtiquetaRequest"
}

Ejemplo de request

{
    "unidades": [
        "123456789012345",
        "12345678901234567890123456789012"
    ]
}

Respuesta

200
Consulta exitosa
{
    "isError": false,
    "data": [
        "797646000004001",
        "70010010200014407173941336808001"
    ],
    "timestamp": "2026-04-16T21:44:31.539Z",
    "id": "e94e4890ab315bc9ecbecbbfd5d1148a9b014a7f"
}

Ejemplo de respuesta

200 Consulta exitosa 
{
    "isError": false,
    "data": [
        "797646000004001",
        "70010010200014407173941336808001"
    ],
    "timestamp": "2026-04-16T21:44:31.539Z",
    "id": "e94e4890ab315bc9ecbecbbfd5d1148a9b014a7f"
}

Errores

400
Validación Zod / cuerpo inválido. En errores de validación el cuerpo suele incluir data: null (sin cause).
{
    "isError": true,
    "message": "Debe enviar al menos una etiqueta",
    "code": "BAD_MESSAGE",
    "data": null,
    "timestamp": "2026-04-16 16:44:31",
    "statusCode": 400,
    "id": "val1"
}
500
Error al consultar BD u otro fallo
{
    "isError": true,
    "message": "Connection timeout",
    "code": "UNKNOWN_ERROR",
    "statusCode": 500,
    "timestamp": "2026-04-16 16:44:31",
    "id": "srv1"
}
403
Denegación externa
[]