Developerski portal

Public REST API za ERP partnere

Standardizirani endpointi za moderne ERP-ove. Autorizacija: header X-API-Key (partnerski ključ iz Godmode integracija).

Neutralna integracijska specifikacija (v1) — za slanje partneru →

POST /api/v1/sap/orders

Prima transportni nalog iz SAP ERP / TM. Svaki klijent dobiva vlastiti API ključ iz Godmode integracija. Ključ ide u zaglavlje X-API-Key ili Authorization: Bearer. Nema dijeljenog zadanog ključa.

Uspješan odgovor vraća via_illyrica_id (VI-000123) i sap_order_id. Nalog je odmah otvoren za uparivanje s prijevoznicima (PENDING_MATCH). Težina se šalje u kilogramima.

curl -X POST https://viaillyrica.com/api/v1/sap/orders \
  -H "Content-Type: application/json" \
  -H "X-API-Key: vil_..." \
  -d '{
    "external_order_id": "SAP-TEST-001",
    "pickup": { "location": "Zagreb", "date_time": "2026-10-20T08:00:00Z" },
    "delivery": { "location": "Vukovar", "date_time": "2026-10-20T14:00:00Z" },
    "cargo_details": { "weight_kg": 12000, "pallets": 18 },
    "price_offered": 400.00
  }'

POST /api/v1/external/loads

Zaprimanje novog tereta. Polja se mogu zvati po vašem izvozu — mapiranje se postavlja u adminu.

curl -X POST https://viaillyrica.com/api/v1/external/loads \
  -H "X-API-Key: vil_..." \
  -H "Content-Type: application/json" \
  -d '{"origin":"Zagreb","destination":"Skopje","weight":22,"cargo_type":"cement"}'

GET /api/v1/external/loads/{id}/status

Provjera statusa pošiljke: KREIRANO, UTOVARENO, U_TRANZITU, ISPORUCENO, OTKAZANO.

curl https://viaillyrica.com/api/v1/external/loads/<id>/status \
  -H "X-API-Key: vil_..."

POST /api/v1/external/webhooks/subscribe

ERP registrira URL za statusne evente. Kad vozač označi isporuku i priloži POD, šaljemo HTTP POST s dokumentom.

curl -X POST https://viaillyrica.com/api/v1/external/webhooks/subscribe \
  -H "X-API-Key: vil_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"https://erp.partner.hr/hooks/via","events":["UTOVARENO","U_TRANZITU","ISPORUCENO"]}'

POST /api/v1/external/files

SFTP drop: CSV ili XML. Agent nadgleda mapu klijenta i šalje novu datoteku ovdje. Pri grešci formata šaljemo e-mail na notify_email partnera. Redak s weight_kg i external_order_id tretira se kao SAP nalog.

Ulazni sandučić naloga

Svaka tvrtka dobije adresu ime-kod@viaillyrica.com. Nalogodavac ili burza pošalje PDF na tu adresu. Funkcija processOrderMailbox pročita tekst, a sken preda OCR-u i AI parseru, pa otvori teret. Ne treba API licenca burze. Ulaz prima tajnu X-Mailbox-Secret ili Svix potpis Resenda.

Parser transportnog naloga

Prepoznaje jedan ili više naloga iz PDF-a: utovar, istovar, termini, težina, LDM, cijena, valuta i rok plaćanja.

Jednostavan unos naloga

Tvrtka zalijepi tekst ili učita datoteku. Ručni unos ostaje za prikolicu, ADR, natječaj i ostala polja.

Jednostavan unos

Zalijepite tekst naloga ili učitajte PDF. Ruta, termini, težina, LDM, cijena i rok plaćanja popune se sami.

POST /api/v1/external/email

Rezerva kad SAP još ne šalje HTTP pozive. Isti API ključ. Tijelo može biti tekst e-maila, JSON nalog ili CSV/XML privitak. Učinak je isti: nalog se otvara prijevoznicima bez izmjene SAP koda.

curl -X POST https://viaillyrica.com/api/v1/external/email \
  -H "X-API-Key: vil_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Transportni nalog",
    "text": "Nalog: SAP-MAIL-001\nUtovar: Zagreb\nIstovar: Vukovar\nTežina: 12000 kg\nPalete: 18\nCijena: 400 EUR"
  }'