Zewnętrzny stan

Zewnętrzny stan pokazuje w Business Central dostępność zapasu z magazynów zewnętrznych, systemów operatorów logistycznych i od dostawców.

Moduł pozwala przesyłać dane do Business Central, aby użytkownik sprawdzał ilość, partię i paletę podczas pracy z dokumentem, bez logowania się do dodatkowego systemu.

❓ Jak to działa

Zewnętrzny system przesyła wpisy przez standardowy interfejs OData v4. Wpisy są widoczne na stronie N24I | Zewnętrzny stan jako Zapisy zewnętrznych stanów.

Jeśli wpis zawiera Zapas zgodny z zapasem w dokumencie, jego dane są dostępne także w wynikach modułu Zapasy wielofirmowe. Wynik zawiera Dostawcę, Zewnętrzny nr zapasu, Ilość, Nr partii i Nr palety.

Z modułu skorzystasz dla zapasów w zewnętrznych magazynach, u operatorów logistycznych oraz u dostawców. Obsługuje również model dropshippingowy, w którym dostawca wysyła towar bezpośrednio do klienta.

🔗 Adres integracji

https://api.businesscentral.dynamics.com/v2.0/{tenantId}/{środowisko}/api/nav24/advancedInventory/v1.0/companies({companyId})/externalInventoryEntries
Parametr Wartość
Publisher nav24
Group advancedInventory
Version v1.0
Entity externalInventoryEntries
Klucz OData systemId

📋 Pola wpisu

Pole API Nazwa w Business Central Opis
systemId - Identyfikator wpisu używany jako klucz OData; tylko do odczytu.
entryNo Nr wpisu Numer wpisu nadawany automatycznie; tylko do odczytu.
vendorNo Nr dostawcy Identyfikator dostawcy; nie musi istnieć w Business Central.
vendorName Dostawca Nazwa dostawcy.
itemNo Zapas Numer zapasu; nie musi istnieć w Business Central.
itemDescription Opis zapasu Opis zapasu.
externalItemNo Zewnętrzny nr zapasu Numer zapasu stosowany przez dostawcę.
lotNo Nr partii Numer partii dostawcy.
palletNo Nr palety Numer palety dostawcy.
quantity Ilość Ilość dostępna u dostawcy.
Informacja

Jeżeli przekażesz Nr partii, ale nie przekażesz pola Zapas, system uzupełni zapas po utworzeniu lub zmianie informacji o tej partii w Business Central.

⚡ Obsługiwane operacje

Operacja Metoda HTTP Opis
Odczyt wszystkich wpisów GET Zwraca listę wpisów.
Odczyt pojedynczego wpisu GET .../({systemId}) Zwraca jeden wpis.
Dodanie wpisu POST Tworzy nowy wpis.
Aktualizacja wpisu PATCH .../({systemId}) Aktualizuje istniejący wpis.
Usunięcie wpisu DELETE .../({systemId}) Usuwa wpis.

Przy operacjach PATCH i DELETE użyj nagłówka If-Match z wartością @odata.etag zwróconą przez API.

💡 Przykłady i scenariusze

Scenariusz: Stan w zewnętrznym magazynie

Potrzeba: Firma zleca operacje magazynowe zewnętrznemu magazynowi. W Business Central tworzy zlecenia, ale bieżący stan, miejsce składowania i numer palety są dostępne tylko w systemie operatora.

Konfiguracja:

  1. Przygotuj integrację, która cyklicznie pobiera dane z systemu operatora i przesyła je do Business Central.
  2. Prześlij dla każdego wpisu co najmniej Zapas i Ilość, a gdy są dostępne także Nr partii oraz Nr palety.
  3. Otwórz dokument z wierszem danego zapasu i sprawdź wyniki w sekcji N24I | Zapasy wielofirmowe.

Rezultat: Użytkownik widzi aktualną ilość w zewnętrznym magazynie podczas pracy z dokumentem. Nie musi logować się do systemu operatora ani kontaktować się z magazynem, aby sprawdzić dostępność.

🛡️ Zasady działania

  • Pola vendorNo i itemNo nie są walidowane względem słowników Business Central, więc dostawca może podać własne identyfikatory.
  • Pola vendorName i itemDescription możesz przesłać. Gdy pozostawisz je puste, a vendorNo lub itemNo istnieje w Business Central, system uzupełni odpowiednio nazwę dostawcy lub opis zapasu.
  • Pole entryNo jest nadawane automatycznie i jest tylko do odczytu. Do adresowania pojedynczego wpisu używaj systemId.