Saltar al contenido principal

Etiqueta Pequeña

Genera etiquetas de 10x10cm para pegar en paquetes. Si la guía tiene múltiples paquetes, genera una página por cada uno.

GET /api/guias/etiqueta-pequena/{guia}

Permiso requerido: guias.read

Parámetros​

ParámetroTipoDescripción
guiastringNúmero de guía (ej: URU030856)

Contenido de la Etiqueta​

  • Logo
  • Código de ruta: MX-{ORIGEN}-{DESTINO}
  • Código único del paquete
  • De: remitente, tipo de entrega, teléfono
  • A: destinatario, dirección, teléfono
  • Servicio, cantidad (X de Y), fecha
  • Código de barras + número de guía

Ejemplo​

curl -X GET "https://ws-api.masaprisaoperativo.com/api/guias/etiqueta-pequena/URU030856" \
  -H "Authorization: Bearer {token}"

Respuesta​

{
  "response": "OK",
  "message": "Etiqueta pequena generada exitosamente",
  "data": {
    "guia": "URU030856",
    "pdf_base64": "JVBERi0xLjQK...",
    "filename": "URU030856_small.pdf"
  }
}

Múltiples Paquetes​

Si la guía tiene varios paquetes, el PDF contendrá múltiples páginas:

  • Página 1: Paquete 1 de 3
  • Página 2: Paquete 2 de 3
  • Página 3: Paquete 3 de 3

Cada etiqueta muestra su número de secuencia.

Decodificar el PDF​

JavaScript​

const response = await fetch('/api/guias/etiqueta-pequena/URU030856', {
  headers: { 'Authorization': 'Bearer ' + token }
});
const json = await response.json();

const pdfData = atob(json.data.pdf_base64);
const bytes = new Uint8Array(pdfData.length);
for (let i = 0; i < pdfData.length; i++) {
  bytes[i] = pdfData.charCodeAt(i);
}
const blob = new Blob([bytes], { type: 'application/pdf' });
window.open(URL.createObjectURL(blob));

C#​

byte[] pdfBytes = Convert.FromBase64String(response.Data.PdfBase64);
File.WriteAllBytes(response.Data.Filename, pdfBytes);

PHP​

$pdfContent = base64_decode($response['data']['pdf_base64']);
file_put_contents($response['data']['filename'], $pdfContent);

:::tip Recomendación de Impresión Imprime en papel adhesivo para facilitar el pegado en los paquetes. El tamaño 10x10cm está optimizado para etiquetas estándar. :::