Create Sales Document | NaviPartner | NP Retail API Documentation

using RestSharp;
var client = new RestClient("https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./ecommerce/documents");
var request = new RestRequest(Method.POST);
request.AddHeader("x-np-api-key", "<NaviPartner API Key>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"externalNo\": \"WEBP000000001\",\n  \"documentType\": \"order\",\n  \"sellToCustomer\": {\n    \"name\": \"Acme Corporation\",\n    \"address\": \"123 Main Street\",\n    \"postCode\": \"10001\",\n    \"city\": \"New York\",\n    \"email\": \"jane.doe@acme.com\",\n    \"no\": \"CUST-10001\",\n    \"address2\": \"Suite 400\",\n    \"county\": \"New York\",\n    \"countryCode\": \"US\",\n    \"contact\": \"Jane Doe\",\n    \"phone\": \"+1-555-123-4567\",\n    \"ean\": \"1234567890123\",\n    \"vatRegistrationNo\": \"US123456789\",\n    \"invoiceEmail\": \"invoices@acme.com\",\n    \"customerTemplate\": \"DOMESTIC\",\n    \"configurationTemplate\": \"CUST000001\"\n  },\n  \"payments\": [\n    {\n      \"paymentMethodType\": \"paymentGateway\",\n      \"externalPaymentMethodCode\": \"adyen_cc\",\n      \"paymentReference\": \"Z3ZR6HT5BNVPZQT5\",\n      \"paymentAmount\": 2000,\n      \"externalPaymentType\": \"mc\",\n      \"customFields\": {\n        \"myCustomField1\": \"myCustomField1Value\",\n        \"myCustomField2\": \"myCustomField2Value\"\n      }\n    },\n    {\n      \"paymentMethodType\": \"voucher\",\n      \"externalPaymentMethodCode\": \"\",\n      \"paymentReference\": \"2807000107658\",\n      \"paymentAmount\": 500,\n      \"externalPaymentType\": \"\",\n      \"customFields\": {\n        \"myCustomField1\": \"myCustomField1Value\",\n        \"myCustomField2\": \"myCustomField2Value\"\n      }\n    }\n  ],\n  \"salesDocumentLines\": [\n    {\n      \"type\": \"item\",\n      \"unitPrice\": 2000,\n      \"quantity\": 2,\n      \"vatPercent\": 25,\n      \"lineAmount\": 2000,\n      \"no\": \"1100\",\n      \"variantCode\": \"\",\n      \"barcodeNo\": \"\",\n      \"description\": \"test item\",\n      \"unitOfMeasure\": \"\",\n      \"customFields\": {\n        \"myCustomField1\": \"myCustomField1Value\",\n        \"myCustomField2\": \"myCustomField2Value\"\n      }\n    }\n  ],\n  \"currencyCode\": \"DKK\",\n  \"currencyExchangeRate\": 1,\n  \"externalDocumentNo\": \"WEBORD-123\",\n  \"yourReference\": \"REF-789\",\n  \"pricesExcludingVat\": false,\n  \"customFields\": {\n    \"myCustomField1\": \"myCustomField1Value\",\n    \"myCustomField2\": \"myCustomField2Value\"\n  },\n  \"shipToCustomer\": {\n    \"name\": \"John Smith\",\n    \"address\": \"456 Shipping Avenue\",\n    \"postCode\": \"10002\",\n    \"city\": \"New York City\",\n    \"address2\": \"Floor 2\",\n    \"county\": \"New York\",\n    \"countryCode\": \"US\",\n    \"contact\": \"John Smith\"\n  },\n  \"comments\": [\n    {\n      \"comment\": \"This is a comment.\"\n    }\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);

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

Authentication

x-np-api-keystring

API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

Request

This endpoint expects an object.

externalNostringRequired

Max. length 20 symbols.

documentTypeenumRequired

Allowed values:

sellToCustomerobjectRequired

paymentslist of objectsRequired

salesDocumentLineslist of objectsRequired

currencyCodestringOptional

Max. length 10 symbols.

currencyExchangeRatedoubleOptional

externalDocumentNostringOptional

Max. length 35 symbols.

locationCodestringOptional

Max. length 10 symbols.

yourReferencestringOptional

pricesExcludingVatbooleanOptional

ticketReservationTokenstringOptional

Used to link the sales document to a ticket reservation, enabling the system to associate ordered ticket items with their pre-reserved admissions. Obtained as the token from the Ticket Reservation API.

ticketHolderstringOptional

The name of the person holding the ticket(s). Max. length 100 symbols.

ticketHolderLanguagestringOptional

The language code the ticket holder wants to receive notifications in. Max. length 10 symbols.

customFieldsobjectOptional

This section allows you to add custom fields as key-value pairs. You can handle these fields by subscribing to our extension publishers and implementing custom deserialization logic.

shipToCustomerobjectOptional

shipmentobjectOptional

commentslist of objectsOptional

Response

This endpoint returns an object.

idUUID

Authentication

Path parameters

Headers

Request

Response