Uputa se odnosi na prijenos podataka stanja zaliha preko API sučelja.
| Općenita uputa | Zalihe |
| API dokumentacija: | https://moj.Minimax.si/SI/API/Home/ModuleDetails/StockEntry |
| Kratek opis: | Omogućeno je pregledavanje prometa zaliha. Omogućeno je dodavanje i mijenjanje prometa zaliha. Omogućeno je brisanje prometa zaliha. Omogućeno je potvrđivanje, otkazivanje prometa zaliha, ispis otpremnice. |
Podatci prometa zaliha:
- StockEntry.
- StockEntryRow.
StockEntry - podaci prometa zaliha
StockEntry | |
Podatak | Opis |
StockEntryType | Podatak označuje vrstu prometa zaliha. Obvezan podatak. Odabir iz:
|
StockEntrySubtype | Podvrsta prometa. Obvezan podatak. Odabir iz: Kod izdavanja (StockEntryType = I) >
Kod primke (StockEntryType = P) >
|
Date | Datum prometa. Obvezan podatak. |
Number | Broj prometa zaliha, samo za čitanje. |
Customer | Stranka. Unese se ID stranke – stranku odaberemo iz šifrarnika stranki, koji ispišemo putem metode GetCustomers. |
Analytic | Analitika. Unese se ID analitike – analitiku odaberemo iz šifrarnika analitika, koji ispišemo putem metode metode GetAnalytics. |
Rabate | Postotak popusta. |
Description | Opis prometa. |
ValueOfReceipt | Ukupna vrijednost primke. Podatak se unosi kod primke od stranke. |
PercentOfDirectCostsOfPurchase | Postotak zavisnih troškova. Podatak se unosi kod primke od stranke. |
Currency | Novčana jedinica. Podatak se unosi kod primke od stranke. Unese se ID novčane jedinice - novčanu jedinicu odaberemo iz šifrarnika novčanih jedinica, koji ispišemo putem metode GetCurrencies. |
ExchangeRate | Tečaj. Podatek se unosi kod primke od stranke. Ako nije upisan predlaže se na temelju novčane jedinice i datuma. |
DeliveryNoteReportTemplate | Postavke ispisa za otpremnicu. Podatak se unosi kod izdavanja stranci i kod prijenosa među skladištima. Unese se ID postavke ispisa – postavke ispisa odaberemo iz šifrarnika postavki ispisa, koji ispišemo putem metode GetReportTemplates. Za otpremnicu se odabere postavka ispisa, gdje je je DisplayType = DO. |
DeliveryNoteDescriptionAbove | Napomena koja će se ispisati kao opis iznad na otpremnici koja se pripremi. Podatak se unosi kod izdavanja stranci i kod prijenosa među skladištima. |
DeliveryNoteDescriptionBelow | Napomena koja će se ispisati kao opis ispod na otpremnici koja se pripremi. Podatak se unosi kod izdavanja stranci i kod prijenosa među skladištima. |
AddresseeName | Sljedeći podaci unose se kod izdavanja stranci i kod prijenosa među skladištima: Naziv primatelja. |
AddresseeAddress | Adresa primatelja. |
AddresseePostalCode | Poštanski broj primatelja. |
AddresseeCity | Naziv pošte primatelja. |
AddresseeCountry | Država primatelja. Unese se ID države – državu odaberemo iz šifrarnika država, koji ispišemo putem metode GetCountries. |
AddresseeCountryName | Naziv države primatelja koji će se prikazati na otpremnici. Podatak se unosi ako AddresseeCountry nije domaća država. |
RecipientName | Sljedeći podaci unose se kod izdavanja stranci i kod prijenosa među skladištima. Naziv primatelja. |
RecipientAddress | Adresa primatelja. |
RecipientPostalCode | Poštanski broj primatelja. |
RecipientCity | Naziv pošte primatelja. |
RecipientCountry | Država primatelja. Unese se ID države – državu odaberemo iz šifrarnika država, koji ispišemo putem metode GetCountries. |
RecipientCountryName | Naziv države primatelja koji će se prikazati na otpremnici. Podatak se unosi ako AddresseeCountry nije domaća država. |
Status | Status prometa zaloge:
|
StockEntryRows | Popis redaka prometa zaliha. |
StockEntryRow - podaci redaka prometa zaliha
StockEntryRow | |
Podatak | Opis |
RowNumber | Redni broj retka. |
Item | Artikl, obvezan podatak. Unese se ID artikla – artikl odaberemo iz šifrarnika artikala, koji ispišemo putem metode GetItems. |
WarehouseFrom | Skladište iz. Podatak se unosi kod izdavanja i kod prijenosa među skladištima. Unese se ID skladišta – skladište odaberemo iz šifrarnika skladišta, koji ispišemo putem metode GetWarehouses. |
WarehouseTo | Skladište u. Podatak se unosi kod primke i kod prijenosa među skladištima. Unese se ID skladišta – skladište odaberemo iz šifrarnika skladišta, koji ispišemo putem metode GetWarehouses. |
Quantity | Količina. |
Price | Cijena. Podatak se unosi kod primke. |
DiscountPercent | Postotak popusta. |
LinkedStockEntryRow | Povezani redak zaliha - podatak se unosi samo kod povrata. Unese se StockEntryRowId izvornog retka na koji se odnosi povrat. |
MarginPercent | Postotak marže. Podatak se unosi kod primke od stranke. |
SellingPrice | Prodajna cijena. |
Value | Vrijednost retka. |
SerialNumber | Serijski broj. Podatak se unosi kod izdavanja, ako u postavkama organizacije imamo postavljeno da se unose serijski brojevi. |
AveragePrice | Prosječna nabavna cijena artikla. Podatak nije nužno ažuran u primjeru da smo unosili promet prije obrađenog prometa te je za ažurne podatke potrebno ponovno pokrenuti vrednovanje / knjiženje zaliha. |
Primjeri
Prilikom formiranja objekta za slanje, možemo si pomoći s testnim podacima objekta koje prikažemo klikom na gumb Test API na pregledu pojedine metode.
Unos novog izdavanja stranci
Metoda: AddStockEntry
Unos bez podataka za otpremnicu (bez primatelja).
StockEntry | |
Podatak | Opis |
StockEntryType | I - izdavanje |
StockEntrySubtype | S - stranci |
Date | 01.05.2019 |
Customer | ID stranke |
StockEntryRow | |
Podatek | Opis |
RowNumber | 1 |
Item | ID prvoga artikla |
WarehouseFrom | ID skladišta |
Quantity | 125 |
StockEntryRow | |
Podatek | Opis |
RowNumber | 2 |
Item | ID drugoga artikla |
WarehouseFrom | ID skladišta |
Quantity | 75 |
JSON
{
"StockEntryId": null,
"StockEntryType": "I",
"StockEntrySubtype": "S",
"Date": "2019-05-01T00:00:00",
"Number": null,
"Customer": {
"ID": 399631,
"Name": "Saop d.o.o.",
"ResourceUrl": "/api/orgs/3840/customers/399631"
},
"Analytic": null,
"Rabate": 0.00,
"Description": "",
"ValueOfReceipt": 0.00,
"PercentOfDirectCostsOfPurchase": 0.00,
"Currency": null,
"ExchangeRate": 0.000000,
"DeliveryNoteReportTemplate": {
"ID": 59478,
"Name": "Standardno - Otpremnica",
"ResourceUrl": "/api/orgs/3840/report-templates/59478"
},
"DeliveryNoteDescriptionAbove": "",
"DeliveryNoteDescriptionBelow": "",
"AddresseeName": "Saop d.o.o.",
"AddresseeAddress": "PUŽEVA 13",
"AddresseePostalCode": "10000",
"AddresseeCity": "ZAGREB",
"AddresseeCountryName": "HRVATSKA",
"AddresseeCountry": {
"ID": 95,
"Name": "HR",
"ResourceUrl": "/api/orgs/3840/countries/95"
},
"RecipientName": null,
"RecipientAddress": null,
"RecipientPostalCode": null,
"RecipientCity": null,
"RecipientCountryName": null,
"RecipientCountry": null,
"Status": "P",
"StockEntryRows": [{
"StockEntryRowId": null,
"StockEntry": null,
"RowNumber": 1,
"Item": {
"ID": 229128,
"Name": "Roba 1",
"ResourceUrl": "/api/orgs/3840/items/229128"
},
"WarehouseFrom": {
"ID": 1192,
"Name": "Skladište",
"ResourceUrl": "/api/orgs/3840/warehouses/1192"
},
"WarehouseTo": null,
"Quantity": 125.000000,
"Price": 151.016216,
"DiscountPercent": 0.00,
"LinkedStockEntryRow": null,
"MarginPercent": 0.00,
"SellingPrice": 0.000000,
"Value": 18877.03,
"SerialNumber": "",
"Mass": 0.000000,
"AveragePrice": 151.016167,
}, {
"StockEntryRowId": null,
"StockEntry": null,
"RowNumber": 2,
"Item": {
"ID": 260210,
"Name": "Proizvod 1",
"ResourceUrl": "/api/orgs/3840/items/260210"
},
"WarehouseFrom": {
"ID": 1192,
"Name": "Skladište",
"ResourceUrl": "/api/orgs/3840/warehouses/1192"
},
"WarehouseTo": null,
"Quantity": 75.000000,
"Price": 20.000000,
"DiscountPercent": 0.00,
"LinkedStockEntryRow": null,
"MarginPercent": 0.00,
"SellingPrice": 0.000000,
"Value": 1500.00,
"SerialNumber": "",
"Mass": 0.000000,
"AveragePrice": 20.000000,
}
],
}
Unos nove primke od stranke
Metoda: AddStockEntry
StockEntry | |
Podatak | Opis |
StockEntryType | P - primka |
StockEntrySubtype | S - od stranke |
Date | 01.05.2019 |
Customer | ID stranke |
StockEntryRow | |
Podatak | Opis |
RowNumber | 1 |
Item | ID prvoga artikla |
WarehouseTo | ID skladišta |
Quantity | 10 |
Price | 150 |
StockEntryRow | |
Podatak | Opis |
RowNumber | 2 |
Item | ID drugoga artikla |
WarehouseTo | ID skladišta |
Quantity | 50 |
Price | 45 |
JSON
{
"StockEntryId": null,
"StockEntryType": "P",
"StockEntrySubtype": "S",
"Date": "2019-05-01T00:00:00",
"Number": 7,
"Customer": {
"ID": 399631,
"Name": "Saop d.o.o.",
"ResourceUrl": "/api/orgs/3840/customers/399631"
},
"Analytic": null,
"Rabate": 0.00,
"Description": "",
"ValueOfReceipt": 3750.00,
"PercentOfDirectCostsOfPurchase": 0.00,
"Currency": {
"ID": 9,
"Name": "HRK",
"ResourceUrl": "/api/orgs/3840/currencies/9"
},
"ExchangeRate": 1.000000,
"DeliveryNoteReportTemplate": null,
"DeliveryNoteDescriptionAbove": "",
"DeliveryNoteDescriptionBelow": "",
"AddresseeName": null,
"AddresseeAddress": null,
"AddresseePostalCode": null,
"AddresseeCity": null,
"AddresseeCountryName": null,
"AddresseeCountry": null,
"RecipientName": null,
"RecipientAddress": null,
"RecipientPostalCode": null,
"RecipientCity": null,
"RecipientCountryName": null,
"RecipientCountry": null,
"Status": "P",
"StockEntryRows": [{
"StockEntryRowId": null,
"StockEntry": null,
"RowNumber": 1,
"Item": {
"ID": 229128,
"Name": "Roba 1",
"ResourceUrl": "/api/orgs/3840/items/229128"
},
"WarehouseFrom": null,
"WarehouseTo": {
"ID": 1192,
"Name": "Skladište",
"ResourceUrl": "/api/orgs/3840/warehouses/1192"
},
"Quantity": 10.000000,
"Price": 150.000000,
"DiscountPercent": 0.00,
"LinkedStockEntryRow": null,
"MarginPercent": 0.00,
"SellingPrice": 0.000000,
"Value": 1500.00,
"SerialNumber": "",
"Mass": 0.000000,
"AveragePrice": 150.964103
}, {
"StockEntryRowId": null,
"StockEntry": null,
"RowNumber": 2,
"Item": {
"ID": 384501,
"Name": "Moj artikl",
"ResourceUrl": "/api/orgs/3840/items/384501"
},
"WarehouseFrom": null,
"WarehouseTo": {
"ID": 1192,
"Name": "Skladište",
"ResourceUrl": "/api/orgs/3840/warehouses/1192"
},
"Quantity": 50.000000,
"Price": 45.000000,
"DiscountPercent": 0.00,
"LinkedStockEntryRow": null,
"MarginPercent": 0.00,
"SellingPrice": 0.000000,
"Value": 2250.00,
"SerialNumber": "",
"Mass": 0.000000,
"AveragePrice": 45.000000
}
]
}
