GEL API v1.0

Services

SPERRGUT

Das Etikett wird vom Fahrer am Tag der Abholung der Ladung mitgebracht. 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": 40,
        "length": 150,
        "width": 50,
        "height": 100
    },
    "amount_of_label": 1,
    "carrier": "gel",
    "service": "sperrgut",
    "reference_number": "ref1234356789",
    "additional_service": {
        "goods_insurance": 1234,
        "express": "until_10",
    },
    "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.
  • express optional. Sie können 2 mögliche Optionen angeben: until_10 - Lieferung bis 10:00 Uhr des nächsten Tages oder until_12 - Abreise bis 12:00 Uhr des nächsten Tages oder next_day - Garantierte Zustellung am nächsten Tag.

Bedarf:

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

Überprüfung der Abreise

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

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
  • label Link zum Lieferschein
  • 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",
        "label": "https://easylox.de/get_label/123456789123456789132456789",
        "price": "0.00"
    }
}

FAHRRAD

Das Etikett wird vom Fahrer am Tag der Abholung der Ladung mitgebracht. 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": 50,
        "length": 150,
        "width": 30,
        "height": 100
    },
    "amount_of_label": 1,
    "carrier": "gel",
    "service": "fahrrad",
    "reference_number": "ref1234356789",
    "additional_service": {
         "goods_insurance": 1234,
         "express": "until_10",
    },
    "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.
  • express optional. Sie können 2 mögliche Optionen angeben: until_10 - Lieferung bis 10:00 Uhr des nächsten Tages oder until_12 - Abreise bis 12:00 Uhr des nächsten Tages oder next_day - Garantierte Zustellung am nächsten Tag.

Bedarf:

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

Überprüfung der Abreise

  • maximale Abmessungen (l/b/h): 220 x 40 x 110 cm
  • maximale Gewicht: 50 kg


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
  • label Link zum Lieferschein
  • 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",
        "label": "https://easylox.de/get_label/123456789123456789132456789",
        "price": "0.00"
    }
}

E-BIKE

Das Etikett wird vom Fahrer am Tag der Abholung der Ladung mitgebracht. 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": 60,
        "length": 150,
        "width": 30,
        "height": 100
    },
    "amount_of_label": 1,
    "carrier": "gel",
    "service": "ebike",
    "reference_number": "ref1234356789",
    "additional_service": {
         "goods_insurance": 1234,
         "express": "until_10",
    },
    "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.
  • express optional. Sie können 2 mögliche Optionen angeben: until_10 - Lieferung bis 10:00 Uhr des nächsten Tages oder until_12 - Abreise bis 12:00 Uhr des nächsten Tages oder next_day - Garantierte Zustellung am nächsten Tag.

Bedarf:

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

Überprüfung der Abreise

  • maximale Abmessungen (l/b/h): 230 x 50 x 120 cm
  • maximale Gewicht: 60 kg


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
  • label Link zum Lieferschein
  • 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",
        "label": "https://easylox.de/get_label/123456789123456789132456789",
        "price": "0.00"
    }
}

PALETTE

Das Etikett wird vom Fahrer am Tag der Abholung der Ladung mitgebracht. 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": 250,
        "length": 100,
        "width": 50,
        "height": 150
    },
    "amount_of_label": 1,
    "carrier": "gel",
    "service": "palette",
    "reference_number": "ref1234356789",
    "additional_service": {
         "goods_insurance": 1234,
         "express": "until_10",
    },
    "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.
  • express optional. Sie können 2 mögliche Optionen angeben: until_10 - Lieferung bis 10:00 Uhr des nächsten Tages oder until_12 - Abreise bis 12:00 Uhr des nächsten Tages oder next_day - Garantierte Zustellung am nächsten Tag.

Bedarf:

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

Überprüfung der Abreise

  • maximale Abmessungen (l/b/h): 130 x 90 x 220 cm
  • maximale RealGewicht: 500 kg
  • maximale VolumenGewicht: 500 kg Formel: (Länge/100 * Breite/100 * Höhe/100) * 150

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
  • label Link zum Lieferschein
  • 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",
        "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": "gel","service": "sperrgut","reference_number": "ref1234356789"}' https://easylox.de/api/v1/create