---
title: Zadanie Zapisu rozbieżności dostawy – Subiekt Nexo (Zdarzenia)
description: "Zadanie służy do automatycznego zapisywania rozbieżności dostawy w polach własnych pozycji dokumentu w systemie Subiekt nexo. Rozbieżności są rejestrowane przez kierowcę na kolektorze w module transportu.   ## Sposób działania 1. PP Mag Automat pobiera do wykonania zadania typu `ZapiszRozbieznosciDostawySubiektNexo`…"
url: "https://ppmag.pl/docs/zadanie-zapisu-rozbieznosci-dostawy-subiekt-nexo-zdarzenia/"
updated: "2026-07-23"
category: PP Mag Automat / Zadania Biznesowe
---

# Zadanie Zapisu rozbieżności dostawy – Subiekt Nexo (Zdarzenia)

Zadanie służy do automatycznego zapisywania rozbieżności dostawy w polach własnych pozycji dokumentu w systemie Subiekt nexo.

Rozbieżności są rejestrowane przez kierowcę na kolektorze w module transportu.

 

## Sposób działania

1. PP Mag Automat pobiera do wykonania zadania typu `ZapiszRozbieznosciDostawySubiektNexo` w liczbie określonej w konfiguracji zadania.
2. System kolejno dla każdego pobranego zadania (dokumentu)
3. System kolejno dla każdego dokumentu uruchamia proces zapisu rozbieżności dostawy:
   1. System odczytuje rozbieżności zapisane w PP Mag. Jeżeli rozbieżności nie zostaną znalezione zadanie kończy się z błędem.
   2. System wyszukuje dokument za pomocą API Subiekta nexo i edytuje pola własne:
   3. Ilość dostarczona, czyli ilość rzeczywista wprowadzona na kolektorze, jest zapisywana we wskazanym polu własnym pozycji dokumentu.
   4. Uwagi wprowadzone na kolektorze są zapisywane we wskazanym polu własnym pozycji dokumentu, jeżeli pole uwag zostało skonfigurowane.
4. System dodaje nowe zdarzenie do dokumentu z wynikiem operacji.

## Konfiguracja parametrów wykonania zadania

Parametry zapisu rozbieżności dostawy ustawia się bezpośrednio w definicji zadania automatycznego.

![Image](https://ppmag.pl/wp-content/uploads/2026/07/image-37.png)

### Konfiguracja pól

W konfiguracji zadania dostępne są następujące parametry:

- **Pole dla ilości** – parametr wymagany. Należy wskazać pole własne (nazwa) pozycji dokumentu, w którym zostanie zapisana ilość dostarczona, czyli ilość rzeczywista wprowadzona przez kierowcę na kolektorze.
- **Pole uwag** – parametr opcjonalny. Można wskazać pole własne (nazwa) pozycji dokumentu, w którym zostaną zapisane uwagi wprowadzone przez kierowcę na kolektorze.

## Konfiguracja pól własnych w Subiekcie nexo

Przed skonfigurowaniem parametrów zadania należy utworzyć odpowiednie pola własne pozycji dokumentu w systemie Subiekt nexo.

Należy utworzyć:

- pole własne pozycji dokumentu przeznaczone do zapisu ilości dostarczonej,
- pole własne pozycji dokumentu przeznaczone do zapisu uwag, jeżeli uwagi mają być przekazywane do systemu Subiekt nexo.

Po utworzeniu pól należy wskazać ich nazwy w konfiguracji parametrów zadania automatycznego.

 Należy wskazać pola własne pozycji dokumentu. Pola własne zdefiniowane dla całego dokumentu nie są obsługiwane przez to zadanie.

## Generowane zdarzenia dokumentu

Podczas wykonywania zadania system generuje następujące zdarzenia:

- `ProbaZapisuRozbieznosciDostawy` – generowane, gdy zapis rozbieżności dostawy zakończy się niepowodzeniem.
- `ZapisRozbieznosciDostawy` – generowane po prawidłowym zapisaniu rozbieżności dostawy.

## Wymagania

- Dokument musi pochodzić z Subiekta nexo.
- Rozbieżności dostawy muszą zostać wcześniej zarejestrowane na kolektorze i zapisane w PP Mag.
- Pole własne pozycji dokumentu przeznaczone do zapisu ilości dostarczonej musi istnieć w systemie Subiekt nexo.
- Jeżeli mają być zapisywane uwagi, odpowiednie pole własne pozycji dokumentu musi istnieć w systemie Subiekt nexo.
- Serwer Sfery (**Sfera Nexo .NET Serwer Automatyczne**) powinien być uruchomiony i działać w tle podczas wykonywania zadania.