Dodawanie zamówienia

Endpoint dodawania zamówienia do aplikacji ifirma.pl:

https://www.ifirma.pl/hub/user/platform/CUSTOM/V1/orders/order

Dostępne metody:

• POST – dodanie nowego zamówienia
• PUT – aktualizacja już dodanego zamówienia, identyfikacja na podstawie identyfikatora zamówienia

Przesłane żądanie powinno być zestawem danych o zamówieniu w formacie JSON, zgodnym ze strukturą przedstawioną w poniższej tabeli:

Nazwa w JSON	Typ danych	Wartości	Wymagane	Opis
id	string	<= 40 znaków	T	identyfikator zamówienia
customId	string	<= 100 znaków	N	zewnętrzne id niestandardowe
status	string	<= 100 znaków Anulowane dla zamówienia anulowanego	T	status zamówienia
created	string	Format: yyyy-MM-dd’T’HH:mm:ss.SSS	T	data utworzenia zamówienia
currency	string	PLN; EUR; GBP; USD; CHF; NOK; JPY; CZK; LTL; UAH; RUB; AUD; DKK; CAD; LVL; RON; SEK; HUF; THB; HKD; NZD; SGD; ISK; HRK; BGN; TRY; ILS; CLP; PHP; MXN; ZAR; BRL; MYR; IDR; INR; KRW; CNY	T	waluta zamówienia zgodna ze standardem ISO 4217
modified	string	Format: Yyyyy-MM-dd’T’HH:mm:ss.SSS	N	data aktualizacji zamówienia
discountTotal	number	> 0.00	N	rabat dla całego zamówienia
discountTax	number	> 0.00	N	podatek od rabatu
shippingTotal	number	>= 0.00	T	koszt dostawy
shippingTax	number	> 0.00	N	podatek od dostawy
productsTotalNet	number	> 0.00	T	kwota do zapłaty bez kosztów dostawy
productsTotalTax	number	>= 0.00	N	podatek od kwoty do zapłaty bez kosztów dostawy
customerId	string	<= 20 znaków	N	zewnętrzny identyfikator klienta
paymentMethod	string	<= 100 znaków	N	sposób płatności
transactionId	string	<= 500 znaków	N	identyfikator transakcji z zewnętrznej integracji
paid	boolean	true; false	N	czy zamówienie zostało opłacone
completed	string	Format: yyyy-MM-dd’T’HH:mm:ss.SSS	N	data zakończenia zamówienia
clientLogin	string	<= 40 znaków	N	login użytkownika składającego zamówienie
message	string	<= 2000 znaków	N	wiadomość od klienta
deliveryType	string	<= 300 znaków	N	sposób dostawy
invoiceRequired	boolean	true; false	N	czy faktura jest wymagana
trackingList (lista trackingu, obiekt opcjonalny)
number	string	<= 50 znaków	N	numer przesyłki
items (pozycje zamówienia)
id	string	<= 200 bajtów	N	zewnętrzne id pozycji zamówienia
name	string	<= 300 znaków	N	nazwa pozycji zamówienia
quantity	number	> 0.0000 <= 100000000	T	ilość
totalPrice	number	> 0.00	T	suma wartości pozycji (ilość * cena za sztukę po rabacie)
totalTax	number	>= 0.00	N	wartość podatku obliczona od sumy wartości pozycji
price	number	> 0.00	T	cena jednostkowa
priceAfterDiscount	number	>=0.00	N	cena jednostkowa po uwzględnieniu rabatu na pozycję
unit	string	<= 10 znaków	N	jednostka pozycji zamówienia
sku	string	?	N	kod sku
type	string	ITEM; HANDLING_FEE	N	typ pozycji zamówienia
offerId	string	<= 100 znaków	N	identyfikator oferty
digital	boolean	true; false	N	czy produkt cyfrowy
billing (adres do rozliczeń, obiekt opcjonalny)
firstName	string	<= 500 znaków	N	imię kupującego
lastName	string	<= 500 znaków	N	nazwisko kupującego
company	string	<= 500 znaków	N	nazwa firmy
address1	string	<= 65 znaków	N	długość sumy pól address1 i address2 nie może przekroczyć 65 znaków
address2	string	<= 65 znaków	N
city	string	<= 65 znaków	N	miasto
state	string	<= 500 znaków	N	województwo
postcode	string	<= 16 znaków	N	kod pocztowy
country	string	<= 70 znaków	N	kraj
email	string	<= 65 znaków	N	adres e-mail
phone	string	<= 32 znaków	N	numer telefonu
regon	string	<= 500 znaków	N	REGON
nip	string	<= 40 znaków	N	NIP
shipping (adres do dostawy, obiekt opcjonalny)
firstName	string	<= 500 znaków	N	imię kupującego
lastName	string	<= 500 znaków	N	nazwisko kupującego
company	string	<= 500 znaków	N	nazwa firmy
address1	string	<= 65 znaków	N	długość sumy pól address1 i address2 nie może przekroczyć 65 znaków
address2	string	<= 65 znaków	N
city	string	<= 65 znaków	N	miasto
state	string	<= 500 znaków	N	województwo
postcode	string	<= 16 znaków	N	kod pocztowy
country	string	<= 70 znaków	N	kraj
email	string	<= 500 znaków	N	adres e-mail
phone	string	<= 32 znaków	N	numer telefonu
regon	string	<= 500 znaków	N	REGON
nip	string	<= 40 znaków	N	NIP
pickupPoint (punkt odbioru, obiekt opcjonalny)
method	string	<= 200 znaków	N	metoda dostawy do punktu odbioru
externalId	string	<= 15 znaków	N	identyfikator zewnętrzny
name	string	<= 200 znaków	N	nazwa punktu odbioru
description	string	<= 200 znaków	N	opis punktu odbioru
street	string	<= 200 znaków	N	ulica punktu odbioru
zipCode	string	<= 200 znaków	N	kod pocztowy punktu odbioru
city	string	<= 200 znaków	N	miasto punktu odbioru
countryCode	string	<= 50 znaków	N	kod kraju punktu odbioru

Przykładowa zawartość żądania (JSON):

{
"id": "ORD-2025-0001",
"customId": "ZAM-INT-98765",
"status": "processing",
"created": "2025-10-22T10:15:30.00",
"currency": "PLN",
"modified": "2025-10-22T11:00:00.00",
"discountTotal": 20.00,
"discountTax": 4.60,
"shippingTotal": 15.00,
"shippingTax": 3.45,
"productsTotalNet": 559.99,
"productsTotalTax": 126.50,       
"customerId": "CUST-00045",
"paymentMethod": "credit_card",
"transactionId": "TXN-ABC123456",
"paid": true,
"completed": "2025-10-22T12:30:00.00",
"clientLogin": "jan.kowalski",
"message": "Proszę o dostawę po godzinie 17:00.",
"deliveryType": "kurier",
"invoiceRequired": true,
"trackingList": [
	{
	"number": "PL1234567890"
	}
	],
"items": [
	{
	"id": "ITM-001",
	"name": "Klawiatura mechaniczna RGB",
	"quantity": 1,
	"price": 349.99,
	"priceAfterDiscount": 329.99,
	"totalPrice": 329.99,
	"totalTax": 75.90,
	"unit": "szt.",
	"sku": "KB-RGB-001",
	"type": "ITEM",
	"offerId": "OFFER-9988",
	"digital": false
	},
	{
	"id": "ITM-002",
	"name": "Mysz bezprzewodowa",
	"quantity": 2,
	"price": 129.50,
	"priceAfterDiscount": 120.00,
	"totalPrice": 240.00,
	"totalTax": 55.20,
	"unit": "szt.",
	"sku": "MYSZ-WL-002",
	"type": "ITEM",
	"offerId": "OFFER-8877",
	"digital": false
	},
	{
	"id": "ITM-003",
	"name": "Opłata manipulacyjna",
	"quantity": 1,
	"price": 10.00,
	"totalPrice": 10.00,
	"totalTax": 2.30,
	"unit": "usługa",
	"type": "HANDLING_FEE",
	"digital": false
	}
	],
"billing": {
	"firstName": "Jan",
	"lastName": "Kowalski",
	"company": "Firma Kowalski Sp. z o.o.",
	"address1": "ul. Lipowa 10",
	"address2": "lok. 3",
	"city": "Warszawa",
	"state": "Mazowieckie",
	"postcode": "00-123",
	"country": "PL",
	"email": "jan.kowalski@example.com",
	"phone": "+48123456789",
	"regon": "012345678",
	"nip": "4166555715"
	},
"shipping": {
	"firstName": "Jan",
	"lastName": "Kowalski",
	"company": "",
	"address1": "ul. Długa 25",
	"address2": "",
	"city": "Warszawa",
	"state": "Mazowieckie",
	"postcode": "00-456",
	"country": "PL",
	"email": "jan.kowalski@example.com",
	"phone": "+48123456789"
	},
"pickupPoint": {
	"method": "InPost",
	"externalId": "PL1234PNT001",
	"name": "Paczkomat WAW123A",
	"description": "Punkt odbioru przy Biedronce",
	"street": "ul. Długa 25",
	"zipCode": "00-456",
	"city": "Warszawa",
	"countryCode": "PL"
	}
}