Create Global Entry

POST

Endpoint for adding a new sale to Global Entry. The sale is identified by the combination of Store, POS Unit and Document No. This combination must be unique for the sale to be added.

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

Headers

x-api-versiondateOptional

Used for API versioning. More details.

Request

This endpoint expects an object.

posStorestringRequired

Identification of the store

posUnitstringRequired

Identification of the POS unit

documentNostringRequired

Sales ticket no.

entryTimedatetimeRequired

entryTypeenumRequired

Allowed values: Direct SaleCredit Sale

postingDatedateRequired

fiscalNumberstringRequired

salesAmountdoubleRequired

discountAmountdoubleRequired

totalAmountExclVATdoubleRequired

totalAmountInclVATdoubleRequired

totalVATAmountdoubleRequired

companystringOptional

customerNostringOptional

salespersonstringOptional

currencyCodestringOptional

currencyFactordoubleOptional

salesLineslist of objectsOptional

List of sold items

paymentLineslist of objectsOptional

List of payments

posInfoslist of objectsOptional

List of Info entries

extensionFieldslist of objectsOptional

Additional data. Definition of fieldId and format of data in fieldValue have to be agreed with receiver of data

Response

This endpoint returns an object.

idUUID

Unique identifier of the added entry

POST

1 curl -X POST https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%20International%20Ltd./pos/globalentry \
2      -H "Content-Type: application/json" \
3      -d '{
4   "posStore": "0321",
5   "posUnit": "POS-031",
6   "documentNo": "12345678",
7   "entryTime": "2024-12-25T12:43:56Z",
8   "entryType": "Direct Sale",
9   "postingDate": "2025-09-16",
10   "fiscalNumber": "F0078865",
11   "salesAmount": 4.5,
12   "discountAmount": 6.78,
13   "totalAmountExclVAT": 90.12,
14   "totalAmountInclVAT": 34.5,
15   "totalVATAmount": 6.7,
16   "company": "Sales Company",
17   "customerNo": "D000188",
18   "salesperson": "CLARK",
19   "currencyCode": "USD",
20   "currencyFactor": 1.23,
21   "salesLines": [
22     {
23       "lineNo": 1,
24       "type": "Item",
25       "code": "15235",
26       "quantity": 9.11,
27       "baseQuantity": 1,
28       "unitPrice": 1.2345,
29       "vatPct": 6.789,
30       "lineDiscountPct": 0.12,
31       "lineDiscountAmountExclVAT": 3.45,
32       "lineDiscountAmountInclVAT": 6.78,
33       "lineAmount": 9.01,
34       "amountExclVAT": 2.34,
35       "amountInclVAT": 5.67,
36       "lineDiscountAmountExclVATLCY": 8.9,
37       "lineDiscountAmountInclVATLCY": 1.23,
38       "amountExclVATLCY": 4.56,
39       "amountInclVATLCY": 7.89,
40       "variantCode": "025",
41       "referenceNumber": "9780201379624",
42       "bomItemCode": "66",
43       "locationCode": "LOC-01",
44       "description": "",
45       "description2": "",
46       "unitOfMeasureCode": "PCS",
47       "currencyCode": "USD",
48       "globalReference": "D6E88A5E52E542F0AAA96F08F40B6EC9",
49       "extensionFields": [
50         {
51           "fieldId": 50100,
52           "fieldValue": "value to apply to the custom field on sales line"
53         }
54       ]
55     }
56   ],
57   "paymentLines": [
58     {
59       "lineNo": 1,
60       "paymentMethod": "CASH",
61       "amountLCY": 4.56,
62       "amount": 7.89,
63       "documentNo": "12345678",
64       "description": "Cash payment",
65       "currencyCode": "USD",
66       "extensionFields": [
67         {
68           "fieldId": 50100,
69           "fieldValue": "value to apply to custom field on payment line"
70         }
71       ]
72     }
73   ],
74   "posInfos": [
75     {
76       "lineNo": 4,
77       "saleLineNo": 1,
78       "infoCode": "AFK",
79       "code": "123-ABC",
80       "description": "description",
81       "quantity": 1,
82       "price": 1.23,
83       "netAmount": 4.56,
84       "grossAmount": 7.89,
85       "discountAmount": 0.12,
86       "extensionFields": [
87         {
88           "fieldId": 50100,
89           "fieldValue": "value to apply to custom field on payment line"
90         }
91       ]
92     }
93   ],
94   "extensionFields": [
95     {
96       "fieldId": 50100,
97       "fieldValue": "value to apply to the custom field on pos entry"
98     }
99   ]
100 }'

200Successful

1 {
2   "id": "0d200aa6-aacd-4b78-b673-c4fb7461f5ea"
3 }

Built with

1	curl -X POST https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%20International%20Ltd./pos/globalentry \
2	-H "Content-Type: application/json" \
3	-d '{
4	"posStore": "0321",
5	"posUnit": "POS-031",
6	"documentNo": "12345678",
7	"entryTime": "2024-12-25T12:43:56Z",
8	"entryType": "Direct Sale",
9	"postingDate": "2025-09-16",
10	"fiscalNumber": "F0078865",
11	"salesAmount": 4.5,
12	"discountAmount": 6.78,
13	"totalAmountExclVAT": 90.12,
14	"totalAmountInclVAT": 34.5,
15	"totalVATAmount": 6.7,
16	"company": "Sales Company",
17	"customerNo": "D000188",
18	"salesperson": "CLARK",
19	"currencyCode": "USD",
20	"currencyFactor": 1.23,
21	"salesLines": [
22	{
23	"lineNo": 1,
24	"type": "Item",
25	"code": "15235",
26	"quantity": 9.11,
27	"baseQuantity": 1,
28	"unitPrice": 1.2345,
29	"vatPct": 6.789,
30	"lineDiscountPct": 0.12,
31	"lineDiscountAmountExclVAT": 3.45,
32	"lineDiscountAmountInclVAT": 6.78,
33	"lineAmount": 9.01,
34	"amountExclVAT": 2.34,
35	"amountInclVAT": 5.67,
36	"lineDiscountAmountExclVATLCY": 8.9,
37	"lineDiscountAmountInclVATLCY": 1.23,
38	"amountExclVATLCY": 4.56,
39	"amountInclVATLCY": 7.89,
40	"variantCode": "025",
41	"referenceNumber": "9780201379624",
42	"bomItemCode": "66",
43	"locationCode": "LOC-01",
44	"description": "",
45	"description2": "",
46	"unitOfMeasureCode": "PCS",
47	"currencyCode": "USD",
48	"globalReference": "D6E88A5E52E542F0AAA96F08F40B6EC9",
49	"extensionFields": [
50	{
51	"fieldId": 50100,
52	"fieldValue": "value to apply to the custom field on sales line"
53	}
54	]
55	}
56	],
57	"paymentLines": [
58	{
59	"lineNo": 1,
60	"paymentMethod": "CASH",
61	"amountLCY": 4.56,
62	"amount": 7.89,
63	"documentNo": "12345678",
64	"description": "Cash payment",
65	"currencyCode": "USD",
66	"extensionFields": [
67	{
68	"fieldId": 50100,
69	"fieldValue": "value to apply to custom field on payment line"
70	}
71	]
72	}
73	],
74	"posInfos": [
75	{
76	"lineNo": 4,
77	"saleLineNo": 1,
78	"infoCode": "AFK",
79	"code": "123-ABC",
80	"description": "description",
81	"quantity": 1,
82	"price": 1.23,
83	"netAmount": 4.56,
84	"grossAmount": 7.89,
85	"discountAmount": 0.12,
86	"extensionFields": [
87	{
88	"fieldId": 50100,
89	"fieldValue": "value to apply to custom field on payment line"
90	}
91	]
92	}
93	],
94	"extensionFields": [
95	{
96	"fieldId": 50100,
97	"fieldValue": "value to apply to the custom field on pos entry"
98	}
99	]
100	}'