Quotation

Returns an array with the rates and services. Creates an orden in the panel of eShip with the data received.

Quotation

Parameters

adress_from

array

required

Sender address.

name

string(35)

required

Sender's name.

company

string(35)

optional

Sender's company (optional).

street1

string(35)

required

Sender Address Line 1. Typically street and number (also inner numbers).

street2

string(35)

optional

Sender Address Line 2. Typically the zone or neighborhood (optional).

city

string(35)

required

Sender's City.

zip

string(35)

required

Sender's Postal / Zip Code.

state

string(35)

required

State or Province.

country

string(2)

required

Country (ISO 2 Code).

phone

string(35)

required

Sender's phone.

email

string(35)

optional

Sender's email.

adress_to

array

required

Destination address.

name

string(35)

required

Receiver's name.

company

string(35)

optional

Receiver's company (optional).

street1

string(35)

required

Receiver Address Line 1. Typically street and number (also inner numbers).

street2

string(35)

optional

Receiver Address Line 2. Typically the zone or neighborhood (optional).

city

string(35)

required

City.

zip

string(35)

required

Receiver Postal / Zip Code.

state

string(35)

required

State or Province.

country

string(2)

required

Country (ISO 2 Code).

phone

string(35)

required

Receiver's phone.

email

string(35)

optional

Receiver's email.

parcels

array

required

Shipping Packages.

[0...25 Max]

array

require (at least one)

# of pieces.

length

decimal(10,2)

required

Length of the package.

width

decimal(10,2)

required

Width of the package.

height

decimal(10,2)

required

Height of the package.

distance_unit

"cm"

"in"

required

Distance unit: Centimeters (cm) or Inches (in).

weight

decimal(10,2)

required

Weight of the package.

mass_unit

"kg"

"lb"

required

Mass unit: Kilograms (kg) or Pounds (lb).

reference

string(35)

optional

Reference text for the package (for some carriers it will appear on the label).

items

array

optional

Shippment Items. Required for international shipments. For reference purposes on local shipments.

[0… 99 Max]

array

optional

quantity

integer

required

Quantity of items.

description

string(35)

required

Item's description.

SKU

string(35)

required

Item's SKU.

price

string(35)

required

Item's price.

weight

float

optional

Item's weight.

currency

'USD'

'USD'

'EUR'

'NZD'

'GBP'

optional

Item's currency.

store_id

string(35)

optional

ID of store's product for fulfillment.

insurance

array

optional

Additional shipment insurance. Reimburse senders whose parcels are lost, stolen, and/or damaged in transit.

amount

decimal(10,2)

required

Amount to insure.

currency

'USD'

'USD'

'EUR'

'NZD'

'GBP'

required

Currency of insurance.

order_info

array

optional

Aditional information of the order.

order_num

string(35)

optional

Order number of the store.

paid

boolean

optional

If payment is done is TRUE.

fulfilled

boolean

optional

If the order is shipped is TRUE.

store

string(35)

optional

eCommerce platforms where the order is created.

shipment

string(35)

optional

Type of shipment chosen by the client.

total_price

decimal(10,2)

optional

Total price of the purchase.

subtotal_price

decimal(10,2)

optional

Subtotal Price of the purchase.

total_tax

float

optional

Taxes of the purchase.

total_shipment

float

optional

Total price of the shipping.

store_id

string(35)

optional

ID of the order in the eCommerce platform. It is useful if store fulfillment is requiered.

custom_declaration

array

optional

contents_type

'GIFT'

'DOCUMENTS'

'SAMPLE'

'MERCHANDISE'

'HUMANITARIAN_DONATION'

'RETURN_MERCHANDISE'

'OTHER'

required

inconterm

'DDP'

'DDU'

required

exporter_reference

string(35)

optional

importer_reference

string(35)

optional

contents_explanation

string(35)

optional

invoice

string(35)

optional

license

string(35)

optional

certificate

string(35)

optional

notes

string(35)

optional

eel_pfc

'NOEEI_30_37_a'

'NOEEI_30_37_h'

'NOEEI_30_37_f'

'NOEEI_30_36'

'AES_ITN'

optional

non_delivery_option

'ABANDON'

'RETURN'

optional

certify

boolean

optional

certify_signer

string(35)

optional

save_order

boolean

optional

FALSE for not keeping order on the platform.

cod

float

optional

Cash on Delivery. Only available with Segmail Express services.

ship_date

date(Y-m-d)

optional

The date the package will be shipped.

notes

string(99)

optional

Additional notes for the messenger (Only with Segmail Express).

JSON

Copied!

                                
    {
        "address_from":{
            "name":"Eric Garcia",
            "phone":"0120120120",
            "street1":"Algo 01",
            "city":"Mexico",
            "state":"CDMX",
            "country":"MX",
            "zip":"01090"
        },
        "address_to":{
            "name":"absa",
            "phone":"0120120120",
            "street1":"aldama 100",
            "state":"Coahuila",
            "city":"Saltillo",
            "country":"MX",
            "zip":"05320"
        },
        "parcels":[
            {
                "length":"10",
                "height":"10",
                "width":"10",
                "distance_unit":"cm",
                "weight":"1",
                "mass_unit":"kg",
                "reference":"Reference 1"
            }
        ]
    }                               
                                
                            

Quotation Response

Parameters

object_id

string

ID of the quote to recover.

Rates

array

Shipping packages.

[0… n]

array

# of pieces.

rate_id

string

ID of the rate.

provider

string

Courier provider.

provider_image_75

string

URL of the logo of Courier provider.

currency

string

Shipping currency.

days

integer

Estimated days-in-transit (natural days).

amount

decimal(10,2)

Total rate.

servicelevel

array

name

string

Service name.

token

string

Service token.

tags

array

'BESTVALUE'

'CHEAPEST'

'FASTEST'

Service attributes.

messages

array

Courier messages for the quotation

[0… n]

array

source

string

Courier

text

string

Message body.

                                
    {
        "object_id":"5b2a77f16b12a",
        "rates": [
            {
                "rate_id":"5b2a77f48b1d0",
                "provider":"DHL Express",
                "provider_image_75":"../assetsimg/dhl_75.png",
                "currency":"USD",
                "days":"1",
                "amount":"18.40",
                "servicelevel": {
                    "name":"EXPRESS DOMESTIC",
                    "token":"N/N"
                },
                "tags": [
                    "BESTVALUE",
                    "FASTEST"
                ]
            },
            {
                "rate_id":"5b2a77f53e7a6",
                "provider":"Estafeta",
                "provider_image_75":"../assetsimg/estafeta_75.png",
                "currency":"USD",
                "days":"3",
                "amount":"15.83",
                "servicelevel": {
                    "name":"Terrestre",
                    "token": "estafeta_3"
                },
                "tags": [
                    "CHEAPEST"
                ]
            }
        ],
        "messages": [],
        "address_from": {
            "name":"Jose Rico",
            "email":"[email protected]",
            "phone":"6621200079",
            "street1":"Paseo de losTamarindos 90",
            "street2":"Bosques de lasLomas",
            "city":"CDMX",
            "state": "CDMX",
            "country": "MX",
            "zip": "05120",
            "company": ""
        },
        "address_to": {
            "name":"Jose Rico",
            "email":"[email protected]",
            "phone":"6621200079",
            "street1":"Jesús del Monte 39",
            "street2":"Hacienda de lasPalmas",
            "city":"CDMX",
            "state":"CDMX",
            "country":"MX",
            "zip":"52763",
            "company": ""
        },
        "parcels": [
            { 
            "length":"10",
            "width":"10",
            "height":"10",
            "distance_unit":"cm",
            "weight":"1",
            "mass_unit":"kg"
            }
        ],
        "insurance": {
            "amount":"0",
            "currency":"USD"
        },
        "items": [
            {
            "quantity":"3",
            "description":"White Pants",
            "SKU":"S1025",
            "price":"100",
            "weight":"10",
            "currency":"1",
            "store_id":""
            }
        ],
        "customs_declaration": {
            "contents_type":"MERCHANDISE",
            "incoterm":"DDU",
            "exporter_reference":"",
            "importer_reference":"",
            "contents_explanation":"",
            "invoice":"",
            "license":"",
            "certificate":"",
            "notes":"",
            "eel_pfc":"NOEEI_30_36",
            "non_delivery_option":"RETURN",
            "certify":"1",
            "certify_signer":"David Rico"
        }
    }                             
                                
                            

Quotation

Parameters

object_id

string

required

ID of the quote to recover.

                                
{
    "object_id":"5ddd708511620",
    "rates": [
        {
            "rate_id":"5ddd708514e0f",
            "provider":"Segmail",
            "provider_image_75":"../assets/img/logo.png",
            "currency":"USD",
            "days":"1",
            "amount":"12.00",
            "servicelevel": {
                "name":"Día Siguiente",
                "token":"SME01"
            },
            "status":"SUCCESS"
        },
        {
            "rate_id":"5ddd708516067",
            "provider":"Segmail",
            "provider_image_75":"../assets/img/logo.png",
            "currency":"USD",
            "days":"0",
            "amount":"14.00",
            "servicelevel": {
                "name":"Mismo Día",
                "token":"SME02"
            },
            "status":"SUCCESS"
        },
        {
            "rate_id":"5ddd7085172b3",
            "provider":"Segmail",
            "provider_image_75":"../assets/img/logo.png",
            "currency":"USD",
            "days":"0",
            "amount":"17.00",
            "servicelevel": {
                "name":"Express",
                "token":"SME03"
            },
            "status":"SUCCESS"
        }
    ],
    "messages":[],
    "address_from": {
        "name":"Grupo Romo",
        "phone":"0120120120",
        "street1":"Algo 01",
        "city":"Mexico",
        "state":"CDMX",
        "country":"MX",
        "zip":"01090",
        "email":"",
        "company":"",
        "street2":""
    },
    "address_to": {
        "name":"absa",
        "phone":"0120120120",
        "street1":"aldama 100",
        "state":"Coahuila",
        "city":"Saltillo",
        "country":"MX",
        "zip":"05320",
        "email":"",
        "company":"",
        "street2":""
    },
    "parcels": [
        {
            "length":"10",
            "height":"10",
            "width":"10",
            "distance_unit":"cm",
            "weight":"1",
            "mass_unit":"kg",
            "reference":"Reference 1"
        }
    ],
    "extras": {
        "amount":"0",
        "ship_date":"2018-07-12",
        "currency":"USD",
        "notes":""
    },
    "items": [
        {
            "quantity":"1",
            "description":"White Pants",
            "SKU":"S1025",
            "price":"50",
            "weight":"0",
            "currency":"USD",
            "store_id":""
        }
    ]
}                         
                                
                            

Shipment

Creates a new shipment with the chosen service.

Shipment

Parameters

rate_id

string

required

ID of the chosen rate.

JSON

Copied!

                                
{
    "rate":"5b182a90c3bb5"
}                          
                                
                            

Shipment Response

Parameters

object_id

string

ID of the transaction.

status

string

Status of the transaction.

label_url

string

URL where the PDF label is located.

tracking_number

string

Tracking number.

tracking_url_provider

string

URL of the tracking number in the provider platform.

commercial_invoice

boolean

If comercial invoice created.

commercial_invoice_url

string

URL to PDF of commercial invoice.

fulfillment

array

Data sent back to eCommerce platform.

status

string

Status of fulfillment.

store

string

eCommerce platform.

order_num

string

Order number in the platform.

piece_labels

array

In case a multipackages, each label.

[0… 25]

array

price_id

string

ID of the piece.

sequence_number

string

Number of the piece of the shipping.

label_url

string

URL where is located the PDF of the piece.

tracking_number

string

Shipping tracking number.

status

string

Tracking status of the piece.

status_details

string

Detail of the tracking status of the piece.

                                
{
    "object_id":"617ee9cae390f",
    "status":"SUCCESS",
    "label_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/617ee9cae390f.pdf",
    "tracking_number":"3875992260",
    "commercial_invoice":"0",
    "tracking_url_provider":"http://www.dhl-usa.com/content/us/en/express/tracking.shtml?brand=DHL&AWB=3875992260",
    "commercial_invoice_url":"null",
    "fulfillment": {
        "status":"not fulfilled",
        "store":"",
        "order_num":"1234"
    }
}
                                
                            

Shipment

Parameters

object_id

string(10)

optional

Shipment ID to retrieve.

tracking_number

string(99)

optional

Estatus de la transacción.

order_number

string(99)

optional

Order number of the shipment.

JSON

Copied!

                                
{
    "object_id":"6b72e5342c5b5",
    "status":"SUCCESS",
    "label_url":"https://api.myeship.co/label/5b72e5342c5b5.pdf",
    "provider": "FedEx",
    "service": "Express Saver",
    "tracking_number":"782291727586",
    "commercial_invoice":"0",
    "commercial_invoice_url":"",
    "tracking_url_provider":
    "https://www.fedex.com/apps/fedextrack/?action=track
    &cntry_code=mx&trackingnumber=782291727586" ,
    "tracking": {
        "status":"UNKNOWN",
        "status_details":"Shipment information sent to FedEx",
        "estimated_delivery":"2020-02-2421:00:00",
        "location":"",
        "timestamp":"2020-02-3104:30:21"
        }
}  
                                
                            

Tracking Status

"UNKNOWN"

The label was generated but has not been scanned by the parcel.

“TRANSIT”

The package is on the way.

“DELIVERED”

The package was successfully delivered.

“RETURNED”

The package was returned to the sender.

“FAILURE”

Indicates a problem in delivering the package to the recipient.

Batch Shipment

Creates label for the shipmentes with the chosen services. A PDF with all the labels is created.

Batch Shipment

Parameters

Rates

array

required

[0.. 10]

array

1 mimimum

ID of the rate.

JSON

Copied!

                                
{
    "rates":[
    "5b2a77f48b1d0",
    "5b2a77f53e7a6" 
    ]
}  
                                
                            

Batch Shipment Response

Parameters

object_id

string

ID of the batch.

batch_labels_url

string(35)

URL of PDF with the labels of the batch.

Status

string

Status of batch.

batch_labels

array

Transactions of every label.

[0… 10]

array

object_id

string

ID of the transaction.

Status

string

Status of the transaction.

label_url

string

URL of label's PDF.

tracking_number

string

Tracking number of the label.

tracking_url_provider

string

URL of tracking number of the shipment in providers platform.

commercial_invoice

boolean

If commercial invoice.

commercial_invoice_url

string

URL of PDF of commercial invoice.

fulfillment

array

Data sent back to eCommerce platform.

status

string

Fulfillment status.

store

string

eCommerce platform.

order_num

string

Order number in the plataform.

label_results

array

Batch label generation results.

succeded

integer

How many labels were created succesfully.

failed

integer

How many lables were not created.

                                
{
    "object_id":"5b2aadcf95852",
    "batch_labels_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/617ee9ca4390f.pdf",
    "status":"SUCCESS",
    "batch_labels": [
        {
        "object_id":"5b2aadd489139.pdf",
        "status":"SUCCESS",
        "label_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/627e2412ae2f.pdf",
        "tracking_number":"7628786384",
        "commercial_invoice":"0",
        "tracking_url_provider":"http://www.dhlusa.com/content/us/en/express/tracking.shtml?brand=DHL&AWB=7628786384",
        "commercial_invoice_url":"null",
        "fulfillment": {
            "status":"not fulfilled",
            "store":"",
            "order_num":"1234"
            }
        },
        {
        "object_id":"5b2aadd55e845.pdf",
        "status":"SUCCESS",
        "label_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/637fe9ca41901.pdf",
        "tracking_number":"4058675937537700626990",
        "tracking_url_provider":"http://estafeta.azurewebsites.net/Tracking/searchByGet/?wayBillType=1wayBill=4058675937537700626990",
        "commercial_invoice":"0",
        "commercial_invoice_url":"null",
        "fulfillment": {
            "status":"not fulfilled",
            "store":"",
            "order_num":"1234"
            }
        }
    ]
    "label_results": {
    "succeeded":"2",
    "failed":"0"
    }
}   
                                
                            

Batch Shipment

Parameters

object_id

string

required

ID of batch to recover.

JSON

Copied!

                                       
{
    "object_id":"5b73a0a3c18ce",
    "status":"SUCCESS",
    "batch_labels_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/617ee9ca4390f.pdf",
    "batch_shipments":"null",
    "label_results": {
        "succeeded":"2",
        "failed":"0"
    },
    "batch_labels": [
        {
            "object_id":"5b73a0a9cff7b"
            "status":"SUCCESS",
            "label_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/627e2412ae2f.pdf",
            "tracking_number":"7416867920",
            "commercial_invoice":"0",
            "commercial_invoice_url":"",
            "tracking_url_provider":"http://www.dhl
            usa.com/content/us/en/express/tracking.shtml
            ?brand=DHL&AWB=7416867920",
            "tracking": {
                "status":"UNKNOWN",
                "status_details":"Shipment information received"
            }
        },
        {
            "object_id":"5b73a0b3f3704",
            "status":"SUCCESS",
            "label_url":"https://s3.us-east-2.amazonaws.com/eship-prod/label/637fe9ca41901.pdf",
            "tracking_number":"7416868373",
            "commercial_invoice":"0",
            "commercial_invoice_url":"",
            "tracking_url_provider":"http://www.dhl
            usa.com/content/us/en/express/tracking.
            shtml?brand=DHL&AWB=7416868373",
            "tracking": {
                "status":"UNKNOWN",
                "status_details":"Shipment information received"
            }
        }            
    ]
}   

                                
                            

Label Settings

Settings to create the PDF label.

Label Settings

Parameters

label_format

'PDF'

'PDF_4x6'

required

PDF format of the label
For regular printers: “PDF”
For termal printers: “PDF_4x6”

label_firstline

string(35)

required

First text line on the label.
Use it for the order number, use: “*Order_Number*”

label_secondline

string(35)

required

Second text line on the label.

JSON

Copied!

                                       

{
    "label_format":"PDF",
    "label_firstline":"*Order_Number*",
    "label_secondline":"Example"
}                 
                
                                
                            

Label Settings

JSON

Copied!

                                             
{
    "label_format":"PDF",
    "label_firstline":"*Order_Number*",
    "label_secondline":"Example"
}               
                                
                            

Pickups

Schedule a pickup for one or more packages with the Courier desired.

Pickups

Parameters

courier

string(35)

string(35)

required

Courier who will do the pickup.

weight

string(35)

required

Total weight of the packages.

mass_unit

string(2)

required

Unit of the total weight.

quantity

integer

required

Number of packages to pick up.

date

date(Y-m-d)

required

Date in which the pick up should be schedule.

time

hour(H:i)

required

First hour avalaible for the pick up.

closetime

hour(H:i)

required

Last hour avalaible for the pick up.

street1

string(35)

required

Line 1 of the address to pick up. Typically Street and number.

street2

string(35)

optional

Line 2 of the address to pick up. Typically colony (optional).

zip

string(35)

required

Zip code of the address to pick up.

city

string(35)

required

City of the pick up.

state

string(35)

required

State of the pick up.

country

string(35)

required

Country of the pick up.

name

string(35)

required

Name of the person responsable of the pick up.

company

string(35)

optional

Company responsable of the pick up.

phone

string(35)

required

Phone number of the person responsable of the pick up.

notes

string(35)

optional

Additional notes of the pick up.

JSON

Copied!

                               
{
    "courier":"DHL",
    "weight":"5",
    "mass_unit":"kg",
    "quantity":"2",
    "date":"2019-05-02",
    "time":"10:00",
    "closetime":"16:00",
    "street1":"Paseo de los Tamarindos 90",
    "street2":"Bosques de las Lomas",
    "zip":"05120",
    "city":"CDMX",
    "state":"CDMX",
    "country":"MX",
    "name":"Alan Sanchez",
    "company":"Segmail",
    "phone":"5591350245",
    "notes":"En sotano 1, zona de proveedores"
}   
                
                    
                                
{
    "status":"SUCCESS",
    "confirmation":"137848",
    "courier":"DHL",
    "date":"2019-05-02",
    "time":"10:00",
    "closetime":"CDMX",
    "weight":"5",
    "mass_unit":"kg",
    "quantity":"2",
    "street1":"Paseo de los Tamarindos 90",
    "street2":"Bosques de las Lomas",
    "zip":"05120",
    "city":"CDMX",
    "state":"CDMX",
    "country":"MX"
}
                                
                            

WEBHOOK

Recieve tracking status updates through post method to a custom URL. You can set this URL on the app Settings tab.

Tracking

Parameters

object_id

string(35)

Shipment unique id.

tracking_number

string(35)

Shipment tracking number.

order_number

string(35)

Order number associated with the shipmen.

status

string(35)

Shipment global status.

status_details

string(35)

Shipment detailed status.

timestamp

date hour

Date in which the checkpoint was created.

estimated_delivery

date hour

Shipment estimated delivery date.

location

string(35)

Last checkpoint location.

Webhook Body:

Copied!

                                                                                
{
    "object_id":"60e37902e86e1",
    "tracking_number":"281115007045",
    "order_number":"#12241",
    "status":"TRANSIT",
    "status_details":"Picked up",
    "timestamp":"2021-07-06 17:56:00",
    "estimated_delivery":"2021-07-08 21:00:00",
    "location":"CUAUTITLAN IZCALLI, MX"
}
                
                                
                            

Webhook ejemplo: