Skip to main content

​
Get Package by Remito Number

Retrieve detailed information about a specific package using its remito (tracking) number.

​
Endpoint

​
method
string
default:"GET"
GET
​
endpoint
string
/encomienda/getEncomiendaByRemito

​
Query Parameters

​
id_remitente
integer
required
Sender’s customer ID
​
remito
string
required
Remito (tracking) number

​
Response

​
data
object
Package information object
​
id
string
Package ID
​
serie_remito
string
Remito/tracking number
​
agencia_origen
string
Origin branch/agency name
​
agencia_destino
string
Destination branch/agency name
​
remitente_nombre
string
Sender’s full name
​
remitente_documento
string
Sender’s document number
​
remitente_direccion
string
Sender’s address
​
celularremitente
string
Sender’s phone number
​
destinatario_nombre
string
Recipient’s full name
​
destinatario_documento
string
Recipient’s document number
​
destinatario_direccion
string
Recipient’s delivery address
​
celulardestino
string
Recipient’s phone number
​
tipo_pago
string
Payment type
​
tipo_entrega
string
Delivery type
​
tipo_envio
string
Shipping type
​
costo_total
string
Total cost
​
kg
string
Weight in kilograms
​
fecha
string
Creation date
​
fecha_entrega
string
Expected delivery date
​
cantidad
string
Number of items
​
medio
string
Shipping method/medium
​
observacion
string
Observations or notes
​
ultimo_estado
string
Current status description
​
color_estado
string
Status color code
​
motorizado
string
Assigned delivery driver name
​
cantidad_total
integer
Total quantity
​
message
string
Error message if package not found

​
Request Example

GET /encomienda/getEncomiendaByRemito?id_remitente=123&remito=RM-2026-001

​
Response Example

{
  "data": {
    "id": "1",
    "serie_remito": "RM-2026-001",
    "agencia_origen": "Lima Centro",
    "agencia_destino": "Arequipa Norte",
    "remitente_nombre": "Juan Pérez",
    "remitente_documento": "12345678",
    "remitente_direccion": "Av. Principal 123",
    "celularremitente": "987654321",
    "destinatario_nombre": "María García",
    "destinatario_documento": "87654321",
    "destinatario_direccion": "Jr. Los Olivos 456",
    "celulardestino": "912345678",
    "tipo_pago": "Efectivo",
    "tipo_entrega": "Domicilio",
    "tipo_envio": "Express",
    "costo_total": "50.00",
    "kg": "5.5",
    "fecha": "2026-03-05",
    "fecha_entrega": "2026-03-10",
    "cantidad": "2",
    "medio": "Terrestre",
    "observacion": "Fragile items",
    "ultimo_estado": "En tránsito",
    "color_estado": "#FFA500",
    "motorizado": "Carlos Rodríguez",
    "cantidad_total": 2
  }
}

​
Get List of Packages

Retrieve a list of packages filtered by branch and date range.

​
Endpoint

​
method
string
default:"GET"
GET
​
endpoint
string
/encomienda/getEncomiendas

​
Query Parameters

​
id_sucursal
integer
required
Branch/agency ID
​
fecha_inicio
string
required
Start date (YYYY-MM-DD format)
​
fecha_fin
string
required
End date (YYYY-MM-DD format)
​
id_motorizado
integer
Optional: Filter by delivery driver ID

​
Response

​
data
array
Array of package objects (same structure as single package response)

​
Request Example

GET /encomienda/getEncomiendas?id_sucursal=1&fecha_inicio=2026-03-01&fecha_fin=2026-03-31

​
Response Example

{
  "data": [
    {
      "id": "1",
      "serie_remito": "RM-2026-001",
      "agencia_origen": "Lima Centro",
      "agencia_destino": "Arequipa Norte",
      "remitente_nombre": "Juan Pérez",
      "destinatario_nombre": "María García",
      "costo_total": "50.00",
      "ultimo_estado": "En tránsito",
      "fecha": "2026-03-05"
    },
    {
      "id": "2",
      "serie_remito": "RM-2026-002",
      "agencia_origen": "Lima Centro",
      "agencia_destino": "Cusco",
      "remitente_nombre": "Ana López",
      "destinatario_nombre": "Pedro Sánchez",
      "costo_total": "75.00",
      "ultimo_estado": "Entregado",
      "fecha": "2026-03-04"
    }
  ]
}

​
Error Response

When a package is not found: 
{
  "message": "No se encontró encomienda"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us