Emons API v1.0

Services

SPERRGUT

Die Etikette wird erstellt und sofort an den Kunden zurückgesandt. Das Datum der Abholung der Ladung ist obligatorisch. Die Abholung der Ladung erfolgt am Tag des Versands an der angegebenen Adresse des Kunden

POST https://easylox.de/api/v1/create
{
    "to": {
        "company": "Paket.ag & EasyLox GmbH",
        "first_name": "Christian",
        "last_name": "Rademaker",
        "street": "Mulweg",
        "street_no": "3a",
        "city": "Schifferstadt",
        "zip_code": "67105",
        "country": "DE",
        "phone": "+4962359159957",
    },
    "from": {
        "company": "Receiver Inc.",
        "first_name": "Max",
        "last_name": "Mustermann",
        "street": "Beispielstrase",
        "street_no": "123",
        "city": "Musterstadt",
        "zip_code": "48455",
        "country": "DE",
        "phone": "555-555",
    },
    "package": { 
        "weight": 5,
        "length": 30,
        "width": 20,
        "height": 10
    },
    "amount_of_label": 1,
    "carrier": "emons",
    "service": "sperrgut",
    "reference_number": "ref1234356789",
    "additional_service": {
        "goods_insurance": 1234,
        "destination_call": 1,
    },
    "pickup": "2020-09-24"
}

Request info:

  • amount_of_label optional. Anzahl identischer Gewichte, Standard 1
  • goods_insurance optional. Der geschätzte Wert der Ladung, mit dem die Versicherung berechnet wird, 0,6%, jedoch nicht weniger als 5,47 Euro ohne Mehrwertsteuer, mit einem geschätzten Wert von 1 Euro bis 990 Euro ohne Mehrwertsteuer.
  • destination_call optional. Die Bestellung eines Anrufs beim Empfänger über die Ankunft im Lager an der Zieladresse kostet 5 Euro ohne MwSt

Bedarf:

  • to Empfängerbereich
  • from Absenderabschnitt
  • package Abschnitt Frachtparameter

Überprüfung der Abreise

  • maximale Abmessungen (l/b/h): 320 x 200 x 200 cm
  • maximale Gurtmaß: 800 Formel: (Zweitlängste Seite + Kürzeste Seite) * 2 + Längste Seite
  • maximale RealGewicht: 60 kg
  • maximale VolumenGewicht: 450 kg Formel: (Länge * Breite * Höhe)/6666

Wenn das Volumengewicht höher ist als das Realegewicht, so wird immer das höhere Gewicht abgerechnet.


Wenn die Bestellung erfolgreich erstellt wurde, gibt die EasyLox.de-API die folgende Antwort zurück:

Response info:

  • id eindeutige Bestellnummer im EasyLox.de-System
  • shipping_id Frachtnummer
  • shipment_url Link zur Bestellung im EasyLox.de-System
  • tracking_url Link zur Verfolgung des Auftragsstatus in EasyLox.de
  • carrier_tracking_url Link, um den Status der Bestellung im System des Transportunternehmens zu verfolgen
  • carrier_tracking_no Verfolgung der Frachtnummer im System des Transportunternehmens
  • label Link zum Etikett
  • price Bestellkosten

Response

200 OK

{
    "0":
    {
        "id" :859902,
        "shipping_id": "123456789123456789132456789",
        "shipment_url": "https://easylox.de/shipment/123456/edit",
        "tracking_url": "https://easylox.de/shipment/123456/tracking",
        "carrier_tracking_url": "https://www.esisk.de/tracking.php?ID=000111000111000",
        "carrier_tracking_no": "000111000111000",
        "label": "https://easylox.de/get_label/123456789123456789132456789",
        "price": "0.00"
    }
}

PALETTE

Die Etikette wird erstellt und sofort an den Kunden zurückgesandt. Das Datum der Abholung der Ladung ist obligatorisch. Die Abholung der Ladung erfolgt am Tag des Versands an der angegebenen Adresse des Kunden

POST https://easylox.de/api/v1/create
{
    "to": {
        "company": "Paket.ag & EasyLox GmbH",
        "first_name": "Christian",
        "last_name": "Rademaker",
        "street": "Mulweg",
        "street_no": "3a",
        "city": "Schifferstadt",
        "zip_code": "67105",
        "country": "DE",
        "phone": "+4962359159957",
    },
    "from": {
        "company": "Receiver Inc.",
        "first_name": "Max",
        "last_name": "Mustermann",
        "street": "Beispielstrase",
        "street_no": "123",
        "city": "Musterstadt",
        "zip_code": "48455",
        "country": "DE",
        "phone": "555-555",
    },
    "package": { 
        "weight": 5,
        "length": 30,
        "width": 20,
        "height": 10
    },
    "amount_of_label": 1,
    "carrier": "emons",
    "service": "palette",
    "reference_number": "ref1234356789",
    "additional_service": {
        "goods_insurance": 1234,
        "destination_call": 1,
    },
    "pickup": "2020-09-24"
}

Request info:

  • amount_of_label optional. Anzahl identischer Gewichte, Standard 1
  • goods_insurance optional. Der geschätzte Wert der Ladung, mit dem die Versicherung berechnet wird, 0,6%, jedoch nicht weniger als 5,47 Euro ohne Mehrwertsteuer, mit einem geschätzten Wert von 1 Euro bis 990 Euro ohne Mehrwertsteuer.
  • destination_call optional. Die Bestellung eines Anrufs beim Empfänger über die Ankunft im Lager an der Zieladresse kostet 5 Euro ohne MwSt

Bedarf:

  • to Empfängerbereich
  • from Absenderabschnitt
  • package Abschnitt Frachtparameter

Überprüfung der Abreise

  • maximale Abmessungen (l/b/h): 150 x 140 x 200 cm
  • maximale RealGewicht: 450 kg
  • maximale VolumenGewicht: 450 kg Formel: (Länge * Breite * Höhe)/6666

Beachten: Ware muss verpackt sein. Ab 49 kg Realgewicht, muss die Ware auf einer Palette stehen.

Wenn das Volumengewicht höher ist als das Realegewicht, so wird immer das höhere Gewicht abgerechnet.


Wenn die Bestellung erfolgreich erstellt wurde, gibt die EasyLox.de-API die folgende Antwort zurück:

Response info:

  • id eindeutige Bestellnummer im EasyLox.de-System
  • shipping_id Frachtnummer
  • shipment_url Link zur Bestellung im EasyLox.de-System
  • tracking_url Link zur Verfolgung des Auftragsstatus in EasyLox.de
  • carrier_tracking_url Link, um den Status der Bestellung im System des Transportunternehmens zu verfolgen
  • carrier_tracking_no Verfolgung der Frachtnummer im System des Transportunternehmens
  • label Link zum Etikett
  • price Bestellkosten

Response

200 OK

{
    "0":
    {
        "id" :859902,
        "shipping_id": "123456789123456789132456789",
        "shipment_url": "https://easylox.de/shipment/123456/edit",
        "tracking_url": "https://easylox.de/shipment/123456/tracking",
        "carrier_tracking_url": "https://www.esisk.de/tracking.php?ID=000111000111000",
        "carrier_tracking_no": "000111000111000",
        "label": "https://easylox.de/get_label/123456789123456789132456789",
        "price": "0.00"
    }
}

Beispielanforderung mit CURL

curl -u :API_KEY -H "Content-Type:  application/json" -d '{"to": {"company": "Paket.ag & EasyLox gmbh","first_name": "christian","last_name": "rademaker","street": "mühlweg","street_no": "3a","city": "schifferstadt","zip_code": "67105","country": "de","phone": "+4962359159957","email": "it@paket.ag"},"from": {"company": "Receiver inc.","first_name": "max","last_name": "mustermann","street": "beispielstraße","street_no": "123","city": "musterstadt","zip_code": "48455","country": "de","phone": "555-555","email": "test@domain.tld"},"package": {"weight": 20,"length": 100,"width": 50,"height": 50},"amount_of_label": 1,"carrier": "emons","service": "sperrgut","reference_number": "ref1234356789"}' https://easylox.de/api/v1/create