SARAH
DocumentationAPI Reference

Calculating Shipping Costs

Learn how to automatically calculate shipping costs using integration with Correo Argentino.

Last updated: 2025-01-26

Sarah's system can automatically calculate shipping costs using integration with Correo Argentino, based on package characteristics and destination.

How It Works

Automatic Process

  1. Enter package information: Weight, dimensions, declared value
  2. Enter destination: Delivery address
  3. System queries Correo Argentino: Gets rates in real time
  4. You receive cost: Calculated cost and available options

Factors Affecting Cost

Shipping cost depends on:

  • Weight: Package weight in grams
  • Dimensions: Height, length, and width in centimeters
  • Declared value: Package content value
  • Delivery type: Home or branch
  • Destination: Province and postal code
  • Product type: Postal letter (CP) or other types

From POS

Add Shipping to a Sale

  1. Create or open a sale in POS
  2. Add products to cart
  3. Enable shipping: Mark "Requires shipping" or similar
  4. Complete shipping information:
    • Destination address
    • Package weight
    • Dimensions (optional, but recommended)
    • Declared value
  5. Calculate shipping: System queries Correo Argentino
  6. Cost is shown: Cost is added to sale

Required Information

Destination Address:

  • Street and number
  • Floor and apartment (optional)
  • City
  • Province (province code)
  • Postal code

Package Characteristics:

  • Weight (in grams)
  • Height (in centimeters)
  • Length (in centimeters)
  • Width (in centimeters)
  • Declared value (in pesos)

Delivery Type:

  • Home (D)
  • Branch (S) - requires agency code

From Online Store

Automatic Calculation in Checkout

In the online store, calculation is automatic:

  1. Customer adds products to cart
  2. Chooses home delivery
  3. Enters destination address
  4. System calculates automatically:
    • Sums product weights
    • Uses estimated dimensions (if configured)
    • Calculates declared value (cart total)
    • Queries Correo Argentino
  5. Shows cost to customer: Customer sees cost before paying

Product Configuration

For accurate calculations, configure in your products:

  • Weight: Individual weight of each product
  • Dimensions: Height, length, and width (optional but recommended)

System automatically sums:

  • Total weight: Sum of weights of all products
  • Dimensions: Calculates total dimensions (or uses estimates)

Delivery Types

Home (D)

Direct delivery to customer's address.

Requirements:

  • Complete and valid address
  • Correct postal code
  • Correct province

Advantages:

  • Convenience for customer
  • Customer doesn't need to travel

Disadvantages:

  • May be more expensive
  • Requires someone to be at address

Branch (S)

Customer picks up at a Correo Argentino branch.

Requirements:

  • Correo Argentino agency code
  • Customer must pick up personally

Advantages:

  • Generally more economical
  • Customer can pick up when they want

Disadvantages:

  • Customer must travel
  • Requires agency code

Get Agencies

You can get the list of available agencies:

  1. From POS or configuration
  2. Select destination province
  3. System queries Correo Argentino
  4. Shows agency list with codes
  5. Select agency for shipping

Calculation Example

Scenario

  • Weight: 500 grams
  • Dimensions: 20cm x 15cm x 10cm
  • Declared value: $5,000
  • Delivery type: Home
  • Destination: CABA, postal code 1425

Process

  1. System prepares request with this data
  2. Queries Correo Argentino API
  3. Receives response with cost
  4. Shows: $1,200 (example)

Result

Cost is added to sale and customer pays it along with products.

Common Errors

Error: "Could not calculate cost"

Possible causes:

  • Integration not configured
  • Invalid credentials
  • Incomplete information
  • Temporary Correo Argentino error

Solution:

  1. Verify integration is configured and enabled
  2. Review that all fields are complete
  3. Try again after a few minutes

Error: "Invalid address"

Possible causes:

  • Incorrect postal code
  • Incorrect province
  • Malformed address

Solution:

  1. Verify postal code
  2. Confirm province is correct
  3. Review address format

Cost Too High or Too Low

Possible causes:

  • Incorrect weight
  • Incorrect dimensions
  • Incorrect declared value

Solution:

  1. Verify package weight
  2. Review dimensions
  3. Confirm declared value

Best Practices

Accuracy in Measurements

  • Weigh products: Don't estimate, actually weigh
  • Measure dimensions: Use real dimensions, not estimates
  • Update regularly: If you change products, update measurements

Declared Value

  • Use real value: Declare real content value
  • Consider insurance: Declared value affects insurance cost
  • Don't underestimate: To protect yourself in case of loss

Product Configuration

  • Configure weight: Add weight to all products
  • Configure dimensions: Add dimensions when possible
  • Use averages: If products vary, use reasonable averages

Next Steps