Skip to content
logo
platformaerp.com

Integracje - Standardowy interfejs logistyczny

Instrukcja opisuje standardowy interfejs logistyczny wykorzystywany do wymiany danych pomiędzy platformaERP a systemem operatora logistycznego.

Pliki

Wersje

  • v3 (doprecyzowania),
  • v4: poprawa przykładu, dodanie informacji o prefiksach nazw plików,
  • v5: doprecyzowanie awiza dostawy, kolejności partii i ilości, ujednolicenie z awizem wydania oraz dodanie spodziewanej daty realizacji i numeru zamówienia w awizie dostawy i wydania,
  • v6: dodanie informacji o ADR, pliku produktów oraz jednostkach miary.

Oprogramowanie zewnętrzne

  • Quantum Qguar
  • WMS Hit Kody

1. Wymagania (operator logistyczny)

Operator logistyczny dostarcza dane do połączenia serwera FTP.

Ogólne zasady działania po stronie platformaERP:

  • Pliki są najpierw wysyłane w formacie txt, a następnie ich nazwa jest zmieniana na csv, aby zapobiec wczytaniu niepełnego pliku.
  • platformaERP generuje pliki, pobiera je oraz przetwarza na dokumenty magazynowe.

2. Informacje ogólne

  • Pola decimal(18,3), jeśli nie są wymagane, mogą mieć wartości przykładowe: pusta wartość, 0, 0.1, 0.12 lub 0.123.
  • Specyfikacja pliku CSV: Unicode UTF-8, nazwa unikalna w cyklu życia systemu, a dane pochodzące z systemów nie mogą zawierać separatora ;.

3. Specyfikacja słownika produktów (generuje platformaERP)

Specyfikacja pliku:

  • Plik jest wysyłany wielokrotnie i zawiera dane różnicowe dla nowych indeksów lub indeksów zmienionych w ciągu ostatnich dni. Jeśli przesyłanych jest kilka komunikatów, ten plik powinien zostać wczytany jako pierwszy.
  • Plik może zawierać te same indeksy. Kluczem indeksu jest kod produktu, dlatego interfejs operatora powinien uwzględniać ten mechanizm, aby nie tworzyć duplikatów.
  • Przykład nazwy: PD20210716092018.csv. Nazwa zawiera znacznik czasu, a wymagany prefiks pliku to PD.
  • Jeśli towary podlegają ADR, należy jednorazowo przekazać operatorowi logistycznemu ręcznie wygenerowaną listę indeksów z odpowiednimi oznaczeniami.
  • Przykład zawartości:
Text Only
1
2
3
4
PR00001650;ALKYL POLYG P06111 (PRÓBKA);szt;;0.000;;PR00001650
PR00001651;ALKYL POLYG P06222 (PRÓBKA);szt;;0.000;;PR00001651
PR00001652;ALKYL POLYG P06333 (PRÓBKA);szt;;0.000;;PR00001652
PR00001653;ALKYL POLYG P06444 (PRÓBKA);szt;;0.000;;PR00001653

4. Dostawa

4.1 Awizo dostawy (generuje platformaERP)

Specyfikacja pliku:

  • Jeden plik = jeden dokument.
  • Przykład nazwy: ZZ075_202106.csv. Nazwa powinna być unikalna dla numeru zamówienia, a wymagany prefiks pliku to ZZ.
  • Przykład zawartości:
Text Only
1
2
3
4
5
6
7
#2;KLK ;EMMER;STEINTOR 1;11111;DE;ZZ018/202109;CE00000035;4320.000;;;;

#2;KLK ;EMMER;STEINTOR 1;11111;DE;ZZ018/202109;CE00000032;4320.000;;;;

#2;KLK ;EMMER;STEINTOR 1;11111;

DE;ZZ018/202109;CE00000008;5760.000;;;;

4.2 Potwierdzenie awiza dostawy (generuje Operator logistyczny)

Specyfikacja pliku:

  • Jeden plik = jeden dokument.
  • Przykład nazwy: PZZ202107151547.csv. Nazwa może być dowolna, ale musi być unikalna. Wymagany prefiks pliku to PZZ.
  • Przykład zawartości:
Text Only
1
2
3
ZZ060/202106;SURPZ
001220;ET00000001;9600;pf6820WsY0810721
ZZ060/202106;SURPZ001220;ET00000002;1920;PF6825wSY040421

5. Wydanie

5.1 Awizo wydania (generuje platformaERP)

Specyfikacja pliku:

  • Jeden plik = jeden dokument.
  • Przykład nazwy: ZS147_202107.csv. Wymagany prefiks pliku to ZS.
  • Przykład zawartości:
Text Only
1
2
3
4
5
6
7
8
9
#41;Syl;Łąka;Letnia 2444;00-004;PL;ZS153/202109;CV00000119;60.000;;1 x DPPL + 1 paleta przemysłowa, Suus, WZ;;2021-09-15 00:00

#41;Syl;Łąka;Letnia 2444;00-004;PL;ZS153/202109;CV00000028;200.000;;1 x DPPL + 1 paleta przemysłowa, Suus, WZ;;2021-09-15 00:00

#41;Syl;Łąka;Letnia 2444;00-004;PL;ZS153/202109;FA00000011;300.000;;1 x DPPL + 1 paleta przemysłowa, Suus, WZ;;2021-09-15 00:00

#41;Syl;Łąka;Letnia 2444;00-004;PL;ZS153/202109;CE00000024;190.000;;1 x DPPL + 1 paleta przemysłowa, Suus, WZ;;2021-09-15 00:00

#41;Syl;Łąka;Letnia 2444;00-004;PL;ZS153/202109;CV00000114;930.000;;1 x DPPL + 1 paleta przemysłowa, Suus, WZ;;2021-09-15 00:00

5.2 Potwierdzenie wydania (generuje operator logistyczny)

Specyfikacja pliku:

  • Jeden plik = jeden dokument.
  • Przykład nazwy: PZS20210715141756.csv. Nazwa może być dowolna, ale musi być unikalna. Wymagany prefiks pliku to PZS.
  • Przykład zawartości:
Text Only
1
2
ZS135/202107;SURWZ007665;SE00000294;1;5704083
ZS135/202107;SURWZ007665;SE00000294;3;5707582

Podsumowanie

W przypadku pytań dotyczących specyfikacji prześlij wiadomość w poniższej formie:

  • 4.2, punkt 2, pole „nr dokumentu”: treść zapytania...
  • Kartoteki indeksów są wysyłane wtedy, gdy mają ustawiony parametr składowanie na TAK.
  • Zamówienia są wysyłane wtedy, gdy mają ustawiony status ZATWIERDZONY.