platformaerp.com

2. Dokument wydania RW,RWP,WZ

User interface

• v_document (również dla dokumentów przyjęcia)
• {{host}}/srs/408-document-view

Obsolete - v_documentout
- {{host}}/pages/erp/documentout - interface

General

documentStatus - status dokumentu
- -1 usunięty - 0 szkic - >0 zatwierdzony
- {app_name} może być zastąpiony [[app_name]]

Pobranie danych dokumentu

SRS/408

Pobranie nagłówka dokumentu

<itm model="command" type="v_document" name="view" label="Dokument" opts="uivisible dtsingle">
...
</itm>

Pobranie pozycji dokumentu

<itm model="command" name="items" label="Pozycje" opts="uiclipboard uivisible">
...
</itm>

Obsolete Request

GET {{host}}/api/erp/document/get/platformaerp/{document_id}

Dodanie nowego dokumentu

• documentDate - data wystawienia dokumentu,
• firmID - kontrahent,
• taxCode - NIP, wtedy gdy wybrano kontrahenta,
• correctedDocumentFullNr - nr dokumentu korygowanego optional,
• warehouseId - magazyn,
• currency - waluta,
• organisationUnitID - wydział,
• documentNR - nr dokumentu, generowany auto lub po wpisaniu wartości optional,
• locationIDB - lokacja docelowa (dla mm, wm),

Słowniki

srs/821:
Lokacja docelowa - location-by-warehouse,
Wydział - organisationUnit,
Magazyn - warehouse-dictionary,
Kontrahent - firmlist,
Zlecenie - open-commision,
Waluta - currency

Dodanie pozycji dokumentu

• itemID - id wybranego indeksu z listy,
• itemQuantity - ilość (szt. kg. ...), danej pozycji,
• itemPrice - cena za indeks,
• locationID - id lokacji, w zależności od ustawienia magazynu (isLocationRequired), jest opcjonalna lub wymagana

<itm model="command" type="v_create_documentline" name="createline" opts="uifooter" css="print-hide">
...
</itm>

Dodanie pozycji przyjęcia

W pozycji przyjęcia cena indeksu jest widoczna i możliwa jest jej zmiana.

Dodanie pozycji wydania

Sposób wyboru indeksu przy dodowaniu pozycji: - mode: 1 -> isGroupedByLocationAndSerialNumberModeAvailable - według lokacji i numeru seryjnego, - mode: 5 -> isGroupedByItemModeAvailable - według indeksu (bez rozbicia na lokacje i nr seryjne), - mode: 3 -> isAgregateLocationsModeAvailable - bez rozbicia na lokacje, - mode: 10 -> isDeliverySelectionAvailable - wybór dostawy

Sposoby sa dostępne jeżęli spełniaja warunki na podstawie parametrów dokumnetu, magazynu etc.:

let isRwpType = this.documentoutline.baseDocumentType.toLowerCase() == "rwp";
let isZO = this.documentoutline.documentType.toLowerCase() == "zo";
let isWM = this.documentoutline.baseDocumentType.toLowerCase() == "wmm";

--fifoexception dla WZR i WZK lub baseDcoumentType jest wmm
let documenType_fifoException = this.documentoutline.documentType == "WZR" || this.documentoutline.documentType == "*WZK" || isWM;
--warehouseFIFO  - jeżeli istnieje metoda wyceny
let warehouseFIFO = this.documentoutline.documentID != null && this.documentoutline.warehouseValuationMethod == 1;
--forceFIFO 
let forceFIFO = documenType_fifoException == false && warehouseFIFO;

this.isDeliverySelectionAvailable = !isRwpType && !isZO && !forceFIFO;
this.isAgregateLocationsModeAvailable = isRwpType && !forceFIFO;
--zawsze wyswietlany
this.isGroupedByItemModeAvailable = true; 
this.isGroupedByLocationAndSerialNumberModeAvailable = !forceFIFO;

Wybór pozycji zlecenia (dla dokumentu RW-P) - Autoamtyczny w ramach zlecenia
/api/core/srs/821/run?dictionary=commisionline-for-rwp-auto - Ręczny wybór pozycji

/api/core/srs/821/run?dictionary=commisionline-for-rwp-manual
 ```

Procedury i srs:  


srs/435

[erp].[item_ListForDocument_dictionary] @username, @remotesource, @remoteid, @query, @itemid, @documentId, @warehouseId

srs/436

[erp].[item_ListForDocumentOut_dictionary] @username, @remotesource, @remoteid, @query, @itemid, @warehouseId, @documentId, @inventoryheetLienId, @itemCode, @locationId, @itemSerialNumber, @mode

srs/437

[erp].[item_ListForDocumentOutRw_dictionary] @username, @remotesource, @remoteid, @query, @itemid, @commisionLineId, @commisionId, @documentId, @mode

srs/438

[erp].[item_ListForDocumentOutZo_dictionary] @username, @remotesource, @remoteid, @query, @itemid, @warehouseid, @documentId, @mode

Response

- data.document - nagłówek   ( SQL PROCEDURE erp.document_get)
- data.documentline - pozycje  ( SQL PROCEDURE erp.documentline_list)

### Wydział

Słowniki są te same jak dla dokumentu przyjęcia.
Przykład pozostałych słowników documentin > słowniki


Request

Wydział

```http
{{host}}/api/erp/dictionary/browse/{{app_name}}/organisationunit

Response

• data.list ( SQL PROCEDURE [erp].[dictionary_bynameValue])

3 Kartotek indeksów dla dokumentu RW

Obsolete SQL

--Według lokacji i numeru seryjnego

 exec [wms].[item_ListForDocumentOut_dictionary] @search=N'697058841718004716',
 @username=N'test35',@warehouseId=N'ff4df207-38b0-e611-93f6-f01fafe8ab47',
 @mode=1,@documentId=N'fdf4f367-d600-eb11-a98a-060c7c3ef0b7'

--OBSOLETE Wdług indeksu (bez rozbicia na lokacje i nr seryjne)

 exec [wms].[item_ListForDocumentOut_dictionary] @search=N'697058841718004716',@username=N'test35',@warehouseId=N'ff4df207-38b0-e611-93f6-f01fafe8ab47',
 @mode=5,@documentId=N'fdf4f367-d600-eb11-a98a-060c7c3ef0b7'

--OBSOLETE Wybór dostawy mode10

exec [wms].[item_ListForDocumentOut_dictionary] @search=N'697058841718004716',
@username=N'test35',@warehouseId=N'ff4df207-38b0-e611-93f6-f01fafe8ab47',
@mode=10,@documentId=N'fdf4f367-d600-eb11-a98a-060c7c3ef0b7'

Request

Według lokacji i numeru seryjnego

GET {{host}}/api/erp/item/browse/{{app_name}}/documentout-by-location-serial
?query={ex: itemname,itemcode}&warehouseid={warehouseid}&documentid={documentid}

Według indeksu (bez rozbicia na lokacje i nr seryjne)

GET {{host}}/api/erp/item/browse/{{app_name}}/documentout-by-item
?query={ex: itemname,itemcode}&warehouseid={warehouseid}&documentid={documentid}

Wybór dostawy

GET {{host}}/api/erp/item/browse/platformaerp/documentin
?query={ex: itemname,itemcode}&warehouseid={warehouseid}&documentid={documentid}

Response

• data.list - lista firm ( SQL PROCEDURE erp.item_list - uwaga endpoitn generycnzy querystring przekazywany do procedury )

5 Dokument, zapisanie nagłówka , zapisanie pozycji , usuwanie pozycji

Request

Zapisanie nagłówka

POST {{host}}/api/erp/document/set-header/platformaerp/{documentid}

Zapisanie pozycji

POST {{host}}/api/erp/document/set-line/platformaerp/{documentid}/{type? dla dokumentów wydania out}
POST {{host}}/api/erp/document/set-line/platformaerp/{documentid}/out

Usuniecie pozycji

POST {{host}}/api/erp/document/delete-line/platformaerp/{documentid}

Example JS

//zapisanie pozycji
this.genericPost('/api/erp/document/set-header/platformaerp/{documentid}', this.api.data.document);

//dodanie pozycji
this.genericPost('/api/erp/document/set-line/platformaerp/{documentid}/out', this.api.data.documentline,this.fetchData);

//usuwanie pozycji
this.genericPost('/api/erp/document/delete-line/platformaerp/{documentLineID}', this.api.data.documentline,this.fetchData);

6 Zatwierdzenie dokumentu , usunięcie dokumentu

Request

Zatwierdzenie

POST {{host}}/api/erp/dictionary/browse/{{app_name}}/commisionline-for-pw?query=&commisionId=&warehouseid=

Usunięcie

POST {{host}}/api/erp/document/set-status/platformaerp/{documentid}?status=-1

7. Obsługa dokumentów o typie RWP basedocumenttype ='RWP'

Wybór zlecenia na nagłówku > patrz documentin

Wybór Sposobu wyboru indeksów

LOGIKA BIZNESOWA

Podczas dodawania pozycji zlecnei Wybór spososobu wyboru zlecenia opcje:

• Automatycznie w ramach zlecenia
• Ręczny wybór pozycji

Request

Ręczny wybór pozycji

GET {{host}}/api/erp/dictionary/browse/{{app_name}}/commisionline-for-rwp-manual?query=[commisionname]&commisionid

Automatyczny w ramach zlecenia

GET {{host}}/api/erp/dictionary/browse/{{app_name}}/commisionline-for-rwp-auto?query=[commisionname]

Obsolete
Ręczny wybór pozycji

https://master.platformacrm.pl/get/p/prompt?topmenu=false&dictName=commisionlinefordocumentout&target=line_autoAssignCommisionLineIdByCommisionId-autoassigncommisionlineidbycommisionid,line_commisionLineID-commisionlineid,line_commisionLineID_dict-commissionlinefullnr,line_commisionID-commisionid,line_manualCommisionLineID-manualcommisionlineid&filters=15b4a9b6-eb39-ea11-a98a-060c7c3ef0b7&filters4=1&q=M00001%2F2020%2F1&_=1601282558491

exec [wms].[commisionline_List_dictionary_documentOut] @search=N'',@username=N'test35',@commisionId=N'15b4a9b6-eb39-ea11-a98a-060c7c3ef0b7',@cutBlockedForOutcomes=1,@linesOnly=N'1'

Automatyczny w ramach zlecenia

https://master.platformacrm.pl/get/p/prompt?topmenu=false&dictName=commisionlinefordocumentout&target=line_autoAssignCommisionLineIdByCommisionId-autoassigncommisionlineidbycommisionid,line_commisionLineID-commisionlineid,line_commisionLineID_dict-commissionlinefullnr,line_commisionID-commisionid,line_manualCommisionLineID-manualcommisionlineid&filters=15b4a9b6-eb39-ea11-a98a-060c7c3ef0b7&filters4=0&q=&_=1601282558493

exec [wms].[commisionline_List_dictionary_documentOut] @search=N'',@username=N'test35',@commisionId=N'15b4a9b6-eb39-ea11-a98a-060c7c3ef0b7',@cutBlockedForOutcomes=1,@linesOnly=N'0'