Skip to main content

​
Overview

App Courier’s package management system handles the complete lifecycle of shipments, from creation to delivery. Packages are called “encomiendas” in the system and include comprehensive sender, recipient, and tracking information.

​
Package Structure

Each package (Encomienda) contains:

Sender Information

  • Name and document number
  • Contact details and phone
  • Pickup address and location
  • Reference/landmark information

Recipient Information

  • Name and document number
  • Delivery address and location
  • Contact details and phone
  • Reference/landmark information

Package Details

  • Weight (kg) and quantity
  • Shipping type and delivery type
  • Estimated delivery date
  • Cost and payment method

Tracking Information

  • Unique remito number
  • Current status
  • Origin and destination branches
  • Assigned driver (if applicable)

​
Creating Packages

1

Select Customer

Choose an existing customer or create a new one. The customer can be the sender or recipient.
2

Enter Sender Details

Provide sender information including:
  • Document number (DNI or RUC)
  • Full name or business name
  • Contact phone number
  • Pickup address details
  • District/location
3

Enter Recipient Details

Provide recipient information:
  • Document number
  • Full name
  • Contact phone number
  • Delivery address
  • District/location
4

Configure Package Details

Set package specifications:
  • Shipping Type: Express, Regular, etc.
  • Delivery Type: Agency-to-Agency, Home Delivery, etc.
  • Weight: Package weight in kilograms
  • Quantity: Number of packages
  • Delivery Date: Expected delivery date
5

Calculate Price

The system automatically calculates the shipping cost based on:
  • Distance between origin and destination
  • Package weight
  • Delivery type
  • Customer’s pricing plan
6

Select Payment Method

Choose payment method:
  • Cash (Contado)
  • Credit (Crédito)
  • Bank Transfer/Deposit (requires bank and operation number)
7

Add Optional Information

  • Sender’s tracking number (guía remitente)
  • Special observations or instructions

​
Package Types

The system supports various shipping types:
Small documents and letters, typically under 0.5 kg
Small document packages, usually 0.5-2 kg
Small merchandise packages, typically 2-5 kg
Standard packages of any size, over 5 kg

​
Delivery Types

Sucursal a SucursalCustomer drops off package at origin branch, recipient picks up at destination branch.
  • Lowest cost option
  • No address required
  • Fastest processing

​
Package Tracking

Every package is assigned a unique remito number (serie_remito) for tracking.

​
Tracking Methods

  1. Quick Search: Enter remito number in the search bar
  2. Package List: Filter by date, branch, status, or customer
  3. Customer View: See all packages for a specific customer
  4. Driver View: View packages assigned to a driver

​
Status Updates

Packages progress through multiple statuses: 
// Common package statuses
"Pendiente"          // Pending pickup/processing
"En tránsito"        // In transit between branches
"En sucursal destino" // Arrived at destination branch
"En reparto"         // Out for delivery
"ENTREGADO"          // Successfully delivered
"Devuelto"           // Returned to sender
Each status change is logged with timestamp and user information in the package history.

​
Managing Packages

​
Viewing Package Details

Click on any package to view:
  • Complete sender and recipient information
  • Current status and location
  • Status history timeline
  • Assigned driver (if applicable)
  • Package images/photos
  • Cost breakdown

​
Updating Package Status

1

Open Package Details

Select the package from the list
2

View Available Statuses

Click “Cambiar Estado” to see valid next statuses
3

Select New Status

Choose the appropriate status from the dropdown
4

Confirm Update

The status updates immediately and appears in the history

​
Assigning Drivers

For home delivery packages:
  1. Open package details
  2. Click “Asignar Motorizado”
  3. Select one or more drivers from the list
  4. Drivers receive the package assignment
  5. Package status updates to “En reparto”

​
Package Images

Attach photos to packages for proof of delivery or condition:
  • Take photos using the device camera
  • Photos are uploaded and linked to the package
  • View all package images in the image gallery
  • Useful for damage claims or delivery confirmation

​
Reporting

​
Available Reports

Package Labels

Print shipping labels with remito number, sender/recipient info, and barcode

Package Lists

Generate lists filtered by date, branch, status, or driver

Delivery Receipts

Print receipts for package pickup or delivery

Status Reports

View package counts by status for operational insights

​
Integration

Package management integrates with:
  • Customer Management: Link packages to customer accounts
  • Pricing Calculator: Automatic cost calculation
  • Branch Management: Route packages between branches
  • Driver Assignment: Assign packages to drivers
  • Status Tracking: Real-time status updates

​
API Reference

For programmatic package management, see:

Create Package

POST /encomienda/createEncomienda

Track Package

GET /encomienda/getEncomiendas

Update Status

POST /encomienda/addEstadoEncomienda

Calculate Price

POST /encomienda/calcularPrecio

​
Best Practices

Always verify addresses: Incorrect addresses are the #1 cause of delivery delays. Double-check district/location information.
Use reference landmarks: Include nearby landmarks in the reference field to help drivers find addresses more easily.
Update statuses promptly: Keep package statuses current so customers have accurate tracking information.

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us