Create Receipt

Creates new receipt in Octopos system. Receipt expects payload with list of items and payments.

Method: POST

Path: /weborder

Sample request

This is request with minimum required data. Prerequisite for this type of request is that all product codes from request already exist is database.

Copy to Clipboard

Sample request with creating new products

This is request will create or update existing products in database. For each item you need to provide additional fields such as: Name, Group, Unit measure, Tax label.

Copy to Clipboard

Sample request with modifiers

This is request will create order with optional modifiers for items.

Copy to Clipboard

Sample request with returning fiscal receipt

This is request will create order and return textual representation of fiscal receipt.

Copy to Clipboard

Sample response

Response returns orderId. After success you can call method get order to get order details. If you want to get fiscal receipt in response, you need to specify ReturnFiscalReceipt=true and FiscalReceiptLineWidth=40 (32 to 60) in payload.

Copy to Clipboard

Sample response with returning fiscal receipt

Response returns orderId and fiscalReceipt.

Copy to Clipboard

{
    "Success": true,
    "Errors": [],
    "Data": {
        "FiscalReceipt": {
            "Id": 245879,
            "TextTop": "=============ФИСКАЛНИ РАЧУН=============\r\n              RS112832835               \r\n          Octopos Software doo          \r\n          Octopos Software doo          \r\n           Vojvode Stepe 101            \r\n                Вождовац                \r\n----------------------------------------\r\nКасир:                   Goran Lazarević\r\nИД купца:                  11:1122334455\r\nЕСИР број:                       602/1.0\r\n-------------ПРОМЕТ ПРОДАЈА-------------\r\n                Артикли                 \r\n========================================\r\nНазив    Цена        Кол.         Укупно\r\n----------------------------------------\r\nCoca Cola Limenka 0.33 (Ж)              \r\n       300,00           1         300,00\r\n----------------------------------------\r\nУкупан износ:                     300,00\r\nПренос на рачун:                  300,00\r\n========================================\r\nОзнака    Име       Стопа          Порез\r\nЖ         VAT      19,00%          47,90\r\n----------------------------------------\r\nУкупан износ пореза:               47,90\r\n========================================\r\nПФР време:          09.04.2022. 00:51:31\r\nПФР број рачуна:   4RPVBTRZ-Dt1Ov1o0-146\r\nБројач рачуна:                  94/146ПП\r\n========================================\r\n",
            "TextBottom": "=========КРАЈ ФИСКАЛНОГ РАЧУНА==========\r\n",
            "VerificationUrl": "https://sandbox.suf.purs.gov.rs/v/?vl=AzRSUFZCVFJaRHQxT3YxbzCSAAAAXgAAAMDGLQAAAAAAAAABgAtgIYIAAA0xMToxMTIyMzM0NDU1tSpoLDDIY8oUtAZSuDBxGpLBa%2Fjn1cQiBvlGrXWe2ysIRZTIrJNA7fEjrku8Jnnt909Hu4bQlLqOiFfZP1V14mx8JTv7Ix6Jlkx1kiQ5uSs3Q0Cxe7QKwtDrglbDbE4DS4l6EwJLE1etqflt1zS0ic%2BfwoowPoIipaP30micdjKU9s%2BVZgpoUV1jYoDe08%2FycQ3VuYJ0WsifVgO7GPKf3xu7RpB9S2Y0o4AfIdk4x2TPpRhE%2FnRUYPSSAuBIbfDnYA06pe9jDj%2BSYI56Knmsjtl0ZGjdxX30EvWnCuaGqLgCSagOEqDey0D3a3A1wLkldtfYNcghgMXlCr9I4O4RAAHS35adFpkOPtgwCJebnlmuw05GAbjeE%2BqWzjW%2Boib9tuWitQ%2FFDgL45u0Nj3be%2F8tHnhzFfbFj0PgQ06LNBOf7mF0CkcYcSsB6MMZqEzAkoND6HJ4icvCh0Prn%2FnW3FHGd%2BGqcvIJAu2qShePzkyktK1je2jU8tU0CJ3miXdbFvh1BIbBUhyfFEHUjtVvriHgprR5Ql77sT1YfJUwS%2BV1v65caaqiGC4RFno3g1wnt1a8dKBGMGYLpTp8xVgm4cpepVRhGYw9aae5i6uusvRpZFWCeNVvSffHpFArjXBPZ%2FmIM48Mh0rQgWRtiKuobtwA54pIMYnwiyIG4F8bXgQpPwWHu2jAnSYa9r4qK0Qob",
            "InvoiceNumber": "4RPVBTRZ-Dt1Ov1o0-146",
            "DoubleFontLineIndexes": []
        },
        "Value": 309484,
        "Errors": [],
        "Success": true
    }
}

Payload details

Field	Data type	Mandatory	Description
TableName	string	No	Table name from method get all tables
CompanyTaxNumber	string	No	Tax number of customer for which order is being created
Info	string	No	Additional note for order
Items	array	Yes	List of receipt items
Items/ProductCode	string	Yes	Product Code from get products or new product code.
Items/ProductName	string	No	Product name (mandatory when creating new product)
Items/GroupName	string	No	Group name (mandatory when creating new product)
Items/UnitMeasure	string	No	Unit measure name (mandatory when creating new product)
Items/TaxLabel	string	No	Tax label (mandatory when creating new product) e.g. А, Е, Ђ
Items/Quantity	number	Yes > 0	Order quantity. Must be greater than 0.
Items/Price	number	Yes	Product price from get products. Price can be one of happy hour prices if there is happy hour definition for product.
Items/Info	string	No	Additional description for order item.
Items/Modifiers	array	No	If product has modifiers.
Items/Modifiers/ProductCode	number	Yes	Product Code from get products or new product code.
Items/Modifiers/ProductName	string	No	Product name (mandatory when creating new product)
Items/Modifiers/GroupName	string	No	Group name (mandatory when creating new product)
Items/Modifiers/UnitMeasure	string	No	Unit measure name (mandatory when creating new product)
Items/Modifiers/TaxLabel	string	No	Tax label (mandatory when creating new product) e.g. А, Е, Ђ
Items/Modifiers/Quantity	number	Yes	Sum of quantity for one order item must be >= product.ModifierMinCount and <= product.ModifierMaxCount.
Items/Modifiers/Price	number	No	If modifier has price.
Payments	array	No	Mandoatory if TableName is empty. Hold a list of payment types to close receipt.
Payments/PaymentTypeId	number	Yes	2=Cash, 3=CreditCard, 4=Invoice
Payments/FiscalPaymentTypeId	number	No	Use this field for electronic fiscalization in Serbia (PaymentTypeId either don’t send or set to 0). Values are 1=Cash (Gotovina) 2=CreditCard (Kartica) 3=Cheque (Ček) 4=Wire transfer (Prenos na račun) 5=Voucher (Vaučer) 6=Mobile payment (Instant plaćanje) 0=Other (Drugo)
Payments/Amount	number	Yes	Amount paid. Sum of all payment amounts must be the same as amount of all order items including modifier prices.
ExternalId	string	No	Use this field to identify your order id. It is not mandatory but it is recommended in order to prevent duplicate requests. In sandbox environment use some prefix because other customers may use same ExternalId (e.g. ExternalId=”octopos-908″)
ElectronicFiscalizationInvoiceType	number	No	Default value is 0 (Normal) Possible values: 0 = Normal (Промет) 1 = ProForma (Предрачун) 2 = Copy (Копија) 3 = Trainig (Обука) 4 = Advance (Аванс)
FiscalReceiptData	object	No	Additional values for fiscal receipt
FiscalReceiptData/ReturnTextualRepresentation	bool	Yes	Default value is false. Set true if you want get fiscal receipt in response.
FiscalReceiptData/LineWidth	number	No	Default value is 40. This will be used to create textual representation of fiscal receipt if FiscalReceiptData/ReturnTextualRepresentation is set to true.
FiscalReceiptData/Jmbg	string	No	JMBG for customer identification
FiscalReceiptData/TaxNumber	string	No	TaxNumber for customer identification
FiscalReceiptData/BuyerId	string	No	Buyer id according to TaxCore specification Рачун са идентификацијом купца (purs.gov.rs)
FiscalReceiptData/BuyerCostCenterId	string	No	Buyer cost center id accoring to TaxCode specificationРачун са идентификацијом купца (purs.gov.rs)
FiscalReceiptData/TextBefore	string	No	Free text to print before Start fiscal receipt line
FiscalReceiptData/TextAfter	string	No	Free text to print after End fiscal receipt line
ReferenceDocumentNumber	string	No	Reference fiscal receipt number (for copy, refund, etc.)
ReferenceDocumentDT	date	No	Reference fiscal receipt issue time (for copy, refund, etc.)