Skip to main content

​
Overview

App Courier’s customer management system handles both individual customers (Natural) and business customers (Jurídico). The system maintains customer profiles, multiple delivery addresses, pricing plans, and payment preferences.

​
Customer Types

Individual Customers
  • Personal customers sending/receiving packages
  • Identified by DNI (national ID)
  • Simple profile with basic information
  • Standard pricing applies
  • Cash or credit payment options

​
Customer Profile Structure

Each customer profile contains:

​
Basic Information

  • Document Number: DNI (8 digits) or RUC (11 digits)
  • Full Name: Customer name or business name (razón social)
  • Phone: Contact phone number
  • Email: Email address (for app customers)
  • Location: Department, Province, District

​
Business Configuration (Jurídico only)

  • Natural: Individual person
  • Jurídico: Business/company
  • Contado: Cash on delivery
  • Crédito: Credit terms (invoicing)
  • Include IGV: Add 18% tax to shipments
  • Exclude IGV: No tax added
  • Configurable per customer
  • Default plan or custom plan
  • Defines base rates per distance
  • Volume discounts
  • Minimum thresholds
Additional delivery fees:
  • extraDomDom: Door-to-door delivery
  • extraAgeDom: Agency to home
  • extraDomAge: Home to agency

​
Managing Customer Addresses

Customers can have multiple delivery addresses stored in their profile.

​
Address Structure

class Direccion {
  String? direccion;   // Street address
  String? referencia;  // Landmark/reference
}

​
Adding Addresses

1

Open Customer Profile

Navigate to the customer details page
2

Click Add Address

Select “Agregar Dirección” button
3

Enter Address Details

  • Full street address
  • Nearby landmark or reference
  • District (if different from profile)
4

Save Address

Address is added to customer’s address list
Store frequently used addresses to speed up package creation. Include landmarks in the reference field.

​
Creating Customers

​
Admin-Created Customers

1

Navigate to Customers

From the admin panel, select “Clientes”
2

Click New Customer

Select “Nuevo Cliente” button
3

Enter Document Number

  • For individuals: 8-digit DNI
  • For businesses: 11-digit RUC
  • System auto-fetches name from government API
4

Verify Information

Review auto-filled name and add missing details:
  • Phone number
  • Email (optional)
  • Location (district)
5

Configure Business Settings

For business customers:
  • Select customer type (Jurídico)
  • Choose payment type
  • Set IGV preference
  • Assign pricing plan
  • Configure extra charges
6

Add Addresses

Add delivery addresses for the customer
7

Save Customer

Customer is created and available for package creation

​
Self-Registration (Customer App)

Customers can register themselves through the mobile app:
1

Download App

Install App Courier from app store
2

Register Account

  • Enter name and email
  • Verify email with code
  • Create password
3

Complete Profile

  • Add document number
  • Add phone number
  • Select location
  • Add delivery addresses
4

Start Using

Request shipments and track packages

​
Updating Customer Information

Customer information can be updated anytime. Changes are reflected immediately in all future packages.

​
Editable Fields

  • Contact information (phone, email)
  • Location (district)
  • Business configuration (for Jurídico)
  • Pricing plan
  • Payment preferences
  • Addresses

​
Protected Fields

  • Document number (cannot be changed)
  • Customer type (Natural/Jurídico)

​
Searching Customers

Quickly find customers using:
  1. Document Number: Enter DNI or RUC
  2. Name Search: Type part of the customer name
  3. Branch Filter: View customers by branch
  4. Type Filter: Show only Natural or Jurídico customers
// Example: Search by document
POST /clientes/buscarCliente
{
  "documento": "12345678",
  "id_sucursal": 1
}

​
Customer Shipping History

View complete shipping history for any customer:
  • All packages sent or received
  • Total shipment count
  • Revenue generated (for reports)
  • Frequent destinations
  • Payment history

​
Viewing History

1

Open Customer Profile

Click on customer in the list
2

Navigate to History

Select “Historial de Envíos” tab
3

Filter Results

Filter by date range, status, or branch
4

View Details

Click any package to see full details

​
Pricing Plans

Business customers can be assigned custom pricing plans.

​
Plan Components

  • Base Rate: Cost per kilometer or zone
  • Minimum Charge: Minimum shipment cost
  • Weight Tiers: Pricing based on weight ranges
  • Discounts: Volume or loyalty discounts

​
Assigning Plans

  1. Select customer profile
  2. Click “Edit” or “Editar Cliente”
  3. Choose plan from dropdown
  4. Save changes
  5. Plan applies to all future shipments
Changing a customer’s plan does not affect existing packages, only new shipments.

​
Customer Types and Features

FeatureNaturalJurídico
Multiple Addresses✅✅
Custom Pricing❌✅
Credit TermsLimited✅
IGV Configuration❌✅
Volume Discounts❌✅
InvoicingBasicFull
Mobile App Access✅✅

​
Integration

Customer management integrates with:
  • Package Creation: Select customers when creating packages
  • Pricing: Customer plan affects shipment costs
  • Invoicing: Generate invoices for credit customers
  • Reporting: Customer analytics and revenue reports
  • Mobile App: Customers can track and request shipments

​
API Reference

For programmatic customer management:

List Customers

GET /clientes/getClientes

Create Customer

POST /clientes/createCliente

Update Customer

POST /clientes/updateCliente

Search Customer

GET /clientes/buscarCliente

​
Best Practices

Verify documents with API: Use the government API integration to auto-fill names from DNI/RUC numbers.
Maintain accurate addresses: Encourage customers to keep addresses updated to avoid delivery issues.
Review business configuration: Double-check IGV and pricing settings for business customers to ensure correct invoicing.

​
See Also

Build docs developers (and LLMs) love

Get started for freeTalk to us