Skip to content
GLobalpaq

Genera una guía

Para generar una guía electrónica en nuestro sistema, es necesario proporcionar una serie de datos específicos, que incluyen la información de la guía, los datos del remitente y del destinatario, las características del paquete, así como los datos requeridos para la emisión del CFDI. Estos elementos son fundamentales para procesar correctamente el envío y cumplir con los requisitos logísticos y fiscales.

Método: POST

Endpoint

Terminal window
https://sistema.globalpaq.mx/api/v3/public/guia

Parámetros Body (Cuerpo)

Guia

Parámetro Descripción Max. Caracteres Obligatorio
tipo Tipo de guía. Debe ser numérico. Consultar articulos. 2 Sí
peso Peso del envío. Numérico. 2 Sí
tipo_papel Define el tipo de papel: 0 para papel normal, 1 para térmico. Si se omite, se usará papel normal. 1 No
saldo_prepago Indica si la operación se debe pagar con saldo prepago. Usa on para activarlo o para desactivarlo off. Si no se envía, se asumirá off. 3 No
valor_seguro Monto por el que desea asegurar. Debe ser un número (entero o decimal) mayor o igual a 1000. Si se omite, el paquete no será asegurado. - No

Shipper

Parámetro Descripción Max. Caracteres Obligatorio
nombre Nombre del remitente. Sin acentos ni caracteres especiales. 29 Sí
compania Nombre de la empresa del remitente. Si no aplica, puede usarse el nombre del remitente. Sin acentos ni caracteres especiales. 35 Sí
telefono Número telefónico del remitente. Solo dígitos. 10 Sí
calle Calle de origen. Sin acentos ni caracteres especiales. 35 Sí
num_ext Número exterior de la calle de origen. Sin caracteres especiales. 5 si
colonia Colonia de origen. Sin acentos ni caracteres especiales. 35 Sí
ciudad Ciudad del remitente. Sin acentos ni caracteres especiales. 35 Sí
estado Estado del remitente abreviado. Ver lista. - Sí
codigo_postal Código postal del remitente. Solo dígitos. 5 Sí
rfc RFC del remitente. Debe ser válido según formato oficial. 13 Sí
email Correo electrónico del remitente. Formato válido, sin acentos. 35 Sí
referencia Referencia del envío del remitente. 29 Sí

Recipient

Parámetro Descripción Max. Caracteres Obligatorio
nombre Nombre del destinatario. Sin acentos ni caracteres especiales. 29 Sí
compania Nombre de la empresa del destinatario. Si no aplica, puede usarse el nombre del destinatario. Sin acentos ni caracteres especiales. 35 Sí
telefono Número telefónico del destinatario. Solo dígitos. 10 Sí
calle Calle de destino. Sin acentos ni caracteres especiales. 35 Sí
num_ext Número exterior de la calle de destino. Sin caracteres especiales. 5 Sí
colonia Colonia de destino. Sin acentos ni caracteres especiales. 35 Sí
ciudad Ciudad del destinatario. Sin acentos ni caracteres especiales. 35 Sí
estado Estado del destinatario abreviado. Ver lista. - Sí
codigo_postal Código postal del destinatario. Solo dígitos. 5 Sí
rfc RFC del destinatario. Debe ser válido según formato oficial. 13 Sí
email Correo electrónico del destinatario. Formato válido, sin acentos. 35 Sí
referencia Referencia del envío del destinatario. 29 Sí

Package

Parámetro Descripción Max. Caracteres Obligatorio
cantidad Número de artículos que contiene el paquete. Solo dígitos. 2 Sí
valor Valor del paquete. Decimal permitido. - Sí
largo Largo del paquete en cm. Solo dígitos. 3 Sí
ancho Ancho del paquete en cm. Solo dígitos. 3 Sí
alto Alto del paquete en cm. Solo dígitos. 3 Sí

cfdi

Parámetro Descripción Max. Caracteres Obligatorio
contenido Descripción del contenido del paquete. Sin acentos ni caracteres especiales. 29 Sí
clave_prod_serv Clave del producto o servicio. Letras y números permitidos. 30 Sí

Para verificar la clave del producto o servicio, visita la página del SAT. En la sección Documentación de la versión 3.0 -> Catálogos del complemento (xls) encontrarás los catálogos requeridos.
Ir al sitio del SAT

Ejemplo del Body (Cuerpo)

{
  "guia": {
    "tipo": 99,
    "peso": 45,
    "tipo_papel": 2,
    "saldo_prepago": "on",
    "valor_seguro": 1000
  },
  "shipper": {
    "nombre": "ANDREA VELÁZQUEZ",
    "compania": "LOGISTICA AVANT",
    "telefono": "1234567890",
    "calle": "CALLE SOLAR 123",
    "num_ext": "110",
    "colonia": "COLONIA CENTRO",
    "ciudad": "Guadalajara",
    "estado": "JAL",
    "codigo_postal": "44100",
    "rfc": "VEVA850101XYZ",
    "email": "andrea@logisticaavant.com",
    "referencia": "Entre calle 1 y calle 2"
  },
  "recipient": {
    "nombre": "MARIO SANDOVAL",
    "compania": "E-COMMERCE MX",
    "telefono": "0987654321",
    "calle": "AVENIDA LUNA 456",
    "num_ext": "110",
    "colonia": "PARQUE INDUSTRIAL",
    "ciudad": "Tijuana",
    "estado": "BCN",
    "codigo_postal": "22000",
    "rfc": "SAMA920202ABC",
    "email": "mario@ecommx.mx",
    "referencia": "Entre calle 1 y calle 2"
  },
  "package": {
    "cantidad": 2,
    "valor": 1000,
    "largo": 120,
    "ancho": 80,
    "alto": 75
  },
  "cfdi": {
    "contenido": "refacciones electronicas",
    "clave_prod": "43211503"
  }
}

Respuesta del Endpoint

{
    "success": true,
    "data": {
        "tracking": "12345678",
        "url": "https://sistema.globalpaq.mx/fedex/guias/12345678.pdf",
        "total": 220.00,
        "cargos": {
            "guia": 120.00,
            "seguro": 100.00,
        }
    }
}