Create Global Entry | NaviPartner | NP Retail API Documentation

1 curl -X POST https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%20International%20Ltd./pos/globalentry \ 2 -H "Authorization: Bearer <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "posStore": "0321", 6 "posUnit": "POS-031", 7 "documentNo": "12345678", 8 "entryTime": "2024-12-25T12:43:56Z", 9 "entryType": "Direct Sale", 10 "postingDate": "2024-12-25", 11 "fiscalNumber": "F0078865", 12 "salesAmount": 649.9, 13 "discountAmount": 80, 14 "totalAmountExclVAT": 519.92, 15 "totalAmountInclVAT": 649.9, 16 "totalVATAmount": 129.98, 17 "company": "Sales Company", 18 "customerNo": "D000188", 19 "salesperson": "CLARK", 20 "currencyCode": "", 21 "currencyFactor": 1, 22 "salesLines": [ 23 { 24 "lineNo": 1, 25 "type": "Item", 26 "code": "80005", 27 "quantity": 1, 28 "baseQuantity": 1, 29 "unitPrice": 249.9, 30 "vatPct": 25, 31 "lineDiscountPct": 0, 32 "lineDiscountAmountExclVAT": 0, 33 "lineDiscountAmountInclVAT": 0, 34 "lineAmount": 249.9, 35 "amountExclVAT": 199.92, 36 "amountInclVAT": 249.9, 37 "lineDiscountAmountExclVATLCY": 0, 38 "lineDiscountAmountInclVATLCY": 0, 39 "amountExclVATLCY": 199.92, 40 "amountInclVATLCY": 249.9, 41 "variantCode": "025", 42 "referenceNumber": "9780201379624", 43 "bomItemCode": "66", 44 "locationCode": "LOC-01", 45 "description": "Hummel Hamar Leggings", 46 "description2": "Co:BLUE Sz:L", 47 "unitOfMeasureCode": "PCS", 48 "currencyCode": "", 49 "globalReference": "D6E88A5E52E542F0AAA96F08F40B6EC9", 50 "extensionFields": [ 51 { 52 "fieldId": 50100, 53 "fieldValue": "value to apply to the custom field on sales line" 54 } 55 ] 56 }, 57 { 58 "lineNo": 2, 59 "type": "Item", 60 "code": "80006", 61 "quantity": 2, 62 "baseQuantity": 2, 63 "unitPrice": 250, 64 "vatPct": 25, 65 "lineDiscountPct": 20, 66 "lineDiscountAmountExclVAT": 80, 67 "lineDiscountAmountInclVAT": 100, 68 "lineAmount": 400, 69 "amountExclVAT": 320, 70 "amountInclVAT": 400, 71 "lineDiscountAmountExclVATLCY": 80, 72 "lineDiscountAmountInclVATLCY": 100, 73 "amountExclVATLCY": 320, 74 "amountInclVATLCY": 400, 75 "variantCode": "L", 76 "referenceNumber": "9780201379648", 77 "locationCode": "LOC-01", 78 "description": "Hummel Alta T-shirt", 79 "description2": "Co:RED Sz:L", 80 "unitOfMeasureCode": "PCS", 81 "currencyCode": "", 82 "globalReference": "84E18BA8D5494605B605CD6192068FC2" 83 }, 84 { 85 "lineNo": 3, 86 "type": "Rounding", 87 "code": "ROUNDINGS", 88 "quantity": 1, 89 "baseQuantity": 1, 90 "unitPrice": 0.1, 91 "vatPct": 0, 92 "lineDiscountPct": 0, 93 "lineDiscountAmountExclVAT": 0, 94 "lineDiscountAmountInclVAT": 0, 95 "lineAmount": 0, 96 "amountExclVAT": 0.1, 97 "amountInclVAT": 0.1, 98 "lineDiscountAmountExclVATLCY": 0, 99 "lineDiscountAmountInclVATLCY": 0, 100 "amountExclVATLCY": 0.1, 101 "amountInclVATLCY": 0.1, 102 "locationCode": "LOC-01", 103 "description": "Rounding", 104 "unitOfMeasureCode": "", 105 "currencyCode": "" 106 } 107 ], 108 "paymentLines": [ 109 { 110 "lineNo": 1, 111 "paymentMethod": "CASH", 112 "amountLCY": 650, 113 "amount": 650, 114 "documentNo": "12345678", 115 "description": "Cash payment", 116 "currencyCode": "", 117 "extensionFields": [ 118 { 119 "fieldId": 50100, 120 "fieldValue": "value to apply to custom field on payment line" 121 } 122 ] 123 } 124 ], 125 "posInfos": [ 126 { 127 "lineNo": 4, 128 "saleLineNo": 1, 129 "infoCode": "AFK", 130 "code": "123-ABC", 131 "description": "description", 132 "quantity": 1, 133 "price": 249.9, 134 "netAmount": 199.92, 135 "grossAmount": 249.9, 136 "discountAmount": 0, 137 "extensionFields": [ 138 { 139 "fieldId": 50100, 140 "fieldValue": "value to apply to custom field on pos info" 141 } 142 ] 143 } 144 ], 145 "extensionFields": [ 146 { 147 "fieldId": 50100, 148 "fieldValue": "value to apply to the custom field on pos entry" 149 } 150 ] 151 }'

1 { 2 "id": "4ca28ccc-e84b-4788-973c-c8ce5a59383b" 3 }

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

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

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:

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