Generar etiquetas

Genera las etiquetas de una o varias guías en formato PDF (por defecto) o ZPL.

POST /etiquetas/imprimir v1.0.0
Autenticación
HTTP Basic, Bearer Token
Ambiente
Testing, Producción

Descripción

Genera las etiquetas de una o varias guías en formato PDF (por defecto) o ZPL.

Si el objeto formato no se envía, el sistema asume PDF automáticamente.

Quick Start

  1. Obtén tus credenciales de acceso (HTTP Basic, 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 /etiquetas/imprimir

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

Parámetros

Sin parámetros declarados.

Body *

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

Ejemplo de request

{
    "tipo_etiqueta": "55",
    "guias": [
        "73941387367"
    ]
}

Respuesta

200
Impresión exitosa
{
    "isError": false,
    "data": [
        {
            "resultado": "Impresión exitosa",
            "zpl": "^XA\n ^FO0,0\n ^GFA,77000,77000,100,:Z64:eJzt3c9v20qeIPBvvXqrygB8rDfoSwUhxMw2..."
        }
    ],
    "timestamp": "2026-02-06T22:12:09.754Z",
    "id": "0c770cc7b6511f06a34a4da278dba536b6d19b16"
}

Ejemplo de respuesta

200 Impresión exitosa 
{
    "isError": false,
    "data": [
        {
            "resultado": "Impresión exitosa",
            "zpl": "^XA\n ^FO0,0\n ^GFA,77000,77000,100,:Z64:eJzt3c9v20qeIPBvvXqrygB8rDfoSwUhxMw2..."
        }
    ],
    "timestamp": "2026-02-06T22:12:09.754Z",
    "id": "0c770cc7b6511f06a34a4da278dba536b6d19b16"
}

Errores

400
Solicitud inválida. Se devuelve cuando formato.tipo no corresponde exactamente a uno de los valores permitidos. Casos típicos: tipo vacío (""), tipo en mayúsculas ("ZPL", "PDF") o formato no permitido ("jpg").
{
    "isError": true,
    "message": "\"formato.tipo\" must be one of [zpl, pdf]",
    "code": "BAD_MESSAGE",
    "data": null,
    "timestamp": "2026-02-06 18:04:12",
    "statusCode": 400,
    "id": "9c4ea0938daad21c25f4376a1b9a7f6d7a219e57"
}
401
Token de acceso vencido o inválido
{
    "fault": {
        "faultstring": "Access Token expired",
        "detail": {
            "errorcode": "keymanagement.service.access_token_expired"
        }
    }
}
404
No se encontraron etiquetas. Ocurre cuando la guía no ha sido generada todavía en el sistema de Coordinadora, o cuando el número de guía no tiene 11 dígitos.
{
    "isError": true,
    "message": "No se encontraron etiquetas",
    "code": "DATA_ERROR",
    "cause": "N/A",
    "data": {
        "resultado": "Error generando la etiqueta - Etiqueta no existe o número inválido",
        "zpl": "",
        "guias_incorrectas": [
            "54879570282"
        ]
    },
    "timestamp": "2026-02-06 16:54:55",
    "statusCode": 404,
    "id": "4c5aed0a26cfcb66a75caa2a68927829de35f209"
}