Saltar al contenido principal

Crear Guía

Crea una o varias guías de envío en una sola petición.

POST /api/guias/crear

Permiso requerido: guias.create

Request Body​

{
  "TipoServicio": "Ocurre",
  "Guia": [
    {
      "Remitente": {
        "Nombre": "Juan Perez",
        "Telefono": "5551234567",
        "Celular": "5559876543",
        "Email": "juan@email.com"
      },
      "Destinatario": {
        "Nombre": "Maria Lopez",
        "Email": "maria@email.com",
        "Telefono": "3331234567",
        "Celular": "3339876543",
        "RazonSocial": "Empresa SA de CV",
        "RFC": "EMP123456ABC",
        "Referencias": "Frente al parque",
        "CodigoPostal": "44100",
        "Estado": "Jalisco",
        "Municipio": "Guadalajara",
        "Colonia": "Centro",
        "Calle": "Av. Juarez",
        "Numero_exterior": "123",
        "Numero_interior": "4B",
        "DestinoCode": "GDLGL"
      },
      "Producto": {
        "TipoEnvio": "Paquete",
        "ValorDeclarado": 500.00,
        "Contenido": "Electronica",
        "InformacionAdicional": "Fragil",
        "Peso": 2.5,
        "Largo": 30,
        "Alto": 20,
        "Ancho": 15
      },
      "Creado_por": {
        "Nombre": "Sistema Web",
        "Agencia": "Tienda Online"
      }
    }
  ]
}

Campos Importantes​

TipoServicio (Requerido)​

ValorDescripción
OcurreEl destinatario recoge en sucursal
DomicilioEntrega a domicilio del destinatario

DestinoCode o CodigoPostal (Uno Requerido)​

Tienes dos opciones para especificar el destino:

CampoDescripción
DestinoCodeCódigo directo de la sucursal destino
CodigoPostalEl sistema obtiene la sucursal automáticamente

:::tip Recomendación Usa solo CodigoPostal y el sistema resuelve la sucursal automáticamente. Si no hay cobertura en ese código postal, recibirás un error descriptivo. :::

Para obtener códigos de sucursal manualmente: GET /api/sucursales/destinos

Para verificar cobertura antes de crear: GET /api/sucursales/cobertura/{cp}

Origen​

:::info Nota El origen se determina automáticamente por la sucursal asignada a tu usuario API. No se envía en el JSON. :::

Respuesta Exitosa​

{
  "response": "OK",
  "message": "Guias creadas: 1",
  "data": [
    {
      "SEND_GUIA": "URU030857",
      "SEND_SUCU_ORIG": "URU",
      "SEND_SUCU_DEST": "GDLGL",
      "SEND_ESTATUS": "Documentado",
      "SEND_FECHA": "2026-07-05T10:30:00",
      "SEND_REMITENTE": "Juan Perez",
      "SEND_DESTINATARIO": "Maria Lopez",
      "SEND_FLETE": 0,
      "SEND_TOTAL": 0
    }
  ]
}

Ejemplo con Auto-Resolución de Sucursal​

Si solo envías CodigoPostal sin DestinoCode, el sistema encuentra la sucursal automáticamente:

{
  "TipoServicio": "Ocurre",
  "Guia": [
    {
      "Remitente": {
        "Nombre": "Juan Perez",
        "Telefono": "5551234567"
      },
      "Destinatario": {
        "Nombre": "Maria Lopez",
        "CodigoPostal": "44100",
        "Estado": "Jalisco",
        "Municipio": "Guadalajara",
        "Colonia": "Centro",
        "Calle": "Av. Juarez",
        "Numero_exterior": "123"
      },
      "Producto": {
        "Contenido": "Electronica"
      },
      "Creado_por": {}
    }
  ]
}

El sistema detecta que el CP 44100 corresponde a la sucursal GDLGL y lo asigna automáticamente.

Crear Múltiples Guías​

Puedes crear varias guías en una sola petición agregando más elementos al array Guia:

{
  "TipoServicio": "Ocurre",
  "Guia": [
    { /* Guía 1 */ },
    { /* Guía 2 */ },
    { /* Guía 3 */ }
  ]
}

Errores Comunes​

ErrorCausa
El campo 'TipoServicio' es requeridoFalta el campo TipoServicio
TipoServicio solo acepta: Domicilio, OcurreValor inválido
Usuario API no tiene sucursal asignadaTu usuario no tiene origen configurado
DestinoCode no corresponde a sucursal válidaCódigo de destino incorrecto
No hay cobertura para el código postal: XXXXXEl CP no tiene sucursal asignada
Se requiere DestinoCode o CodigoPostalFalta información de destino

Ejemplo cURL​

curl -X POST "https://ws-api.masaprisaoperativo.com/api/guias/crear" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "TipoServicio": "Ocurre",
    "Guia": [{
      "Remitente": {"Nombre": "Juan Perez"},
      "Destinatario": {"Nombre": "Maria Lopez", "DestinoCode": "GDLGL"},
      "Producto": {"Contenido": "Documentos"},
      "Creado_por": {}
    }]
  }'