Skapa en Exact Online-försäljningsorder med detaljer via REST-anrop

Den här artikeln visar hur man skapar en försäljningsorder med rader i Exact Online med hjälp av de REST-baserade tabellerna.

Skapande av försäljningsorder rekommenderas generellt med Exact Online XML API:erna, av skäl som ungefär 3 gånger bättre genomströmning och en storleksordning högre dagliga kvoter. XML API:erna kan nås med UploadXMLTopics eller https://go.invantive.eu/get-my-report med ett Excel-ark som indata. Fler tips finns i avsnittet Prestanda nedan.

Instruktioner för att skapa försäljningsorder och försäljningsorderrader

Exact Online har egenheten att varje transaktion måste ha minst en rad, vilket gäller för försäljningsorder, försäljningsfakturor och huvudboktransaktioner. En vanlig insert-sats skapar dock bara huvudet. Därför måste huvudet och raderna skickas till Exact Online i en och samma transaktion.

Invantive SQL tillhandahåller transaktionslogik för att åstadkomma detta. Samma transaktionslogik används även för andra anslutningar, till exempel vid skapande av EDIFACT-filer.

När du kör Invantive SQL-satserna nedan skapas en försäljningsorder som:

Följ dessa steg för att skapa en sådan försäljning:

  • Välj Exact Online-företaget:
use COMPANYNUMBER
  • Aktivera loggning av native-anrop om du vill hålla koll på den faktiska kommunikationen med Exact Online med hjälp av:
set trace-native-calls true

set log-native-calls-to-disk
begin transaction
  • Definiera innehållet i en försäljningsorder:
insert into exactonlinerest..salesorders
( orderedby
, description
) 
--
-- Select a random customer and define a transaction 'TRANSACTION1',
-- one per sales order.
-- You can define and upload multiple Exact Online sales orders
-- and send them off in one Invantive SQL transaction.
--
select act.id
,      'buy some items' description
from   exactonlinerest..accounts act
where  act.status = 'C'
limit  1
identified by 'TRANSACTION1'
  • Lägg till tio försäljningsorderrader till försäljningsordern, var och en med en slumpmässigt vald artikel:
insert into ExactOnlineREST..salesorderlines 
( item
, linenumber
)
select itm.id
,      row_number()
       linenumber
from   exactonlinerest..items itm
where  itm.IsSalesItem = true
limit 10
attach to 'TRANSACTION1'
  • Lämna över försäljningsordern och tillhörande försäljningsorderrader till Exact Online i ett enda REST API-anrop:
commit transaction
  • Efter commit kommer Exact Online att returnera eventuella valideringsfel.
  • Det utgående native-anropet som finns i loggmappen kommer att likna (radbrytningar tillagda för läsbarhet):
Outbound https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders Request using POST started at 2020-06-02 16:43:01 (UTC).
Object: ExactOnlineREST.SalesOrder.SalesOrders
Partition: 102673
Data container ID: https://start.exactonline.nl/8045575
User: john.doe@acme.com

{"Description":"buy some items","OrderedBy":"6d0bfbeb-730f-4290-b886-007392d22a0f"
,"SalesOrderLines":
[ {"Item":"1db1fa03-4b2d-4a54-bee2-005edae3934c","LineNumber":21}
,{"Item":"127fba93-64ce-4cb8-bd9c-00653edf0a13","LineNumber":22}
,{"Item":"46dd7805-15ab-4360-a383-008ce7f46811","LineNumber":23}
,{"Item":"0ed58c10-be4d-4cb9-9ffd-0100d261dc3b","LineNumber":24}
,{"Item":"8194860a-4624-4517-a54f-01194fe2f97d","LineNumber":25}
,{"Item":"cd09577e-e541-4e99-a495-020ab56faa78","LineNumber":26}
,{"Item":"65484fc2-c60c-4b3d-8538-021ad2036ee5","LineNumber":27}
,{"Item":"6e65e4cd-130c-4b3c-8f20-0255283e6368","LineNumber":28}
,{"Item":"0d998f82-fc15-48a8-bc6e-0261a89f0645","LineNumber":29}
,{"Item":"8fa70684-cce7-4916-b4fd-028a7c5af6d4","LineNumber":30}
]
}
  • Svaret från Exact Online, tolkat av Invantive SQL, kommer att likna:
Inbound https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders POST started at 2020-06-02 16:43:01 (UTC).
Object: ExactOnlineREST.SalesOrder.SalesOrders
Partition: 102673
Data container ID: https://start.exactonline.nl/8045575
User: john.doe@acme.com

{
"d" : {
"__metadata": {
"uri": "https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders(guid'94feaad3-69cc-46ad-9925-d02d2b7f994a')"
, "type": "Exact.Web.Api.Models.SalesOrder"
}
...
, "Created": "\/Date(1591123382670)\/"
, "Creator": "bd0e191e-6fb4-4537-bf91-9f68d4e62744"
, "CreatorFullName": "John Doe"
, "Currency": "EUR"
, "DeliverTo": "6d0bfbeb-730f-4290-b886-007392d22a0f"
, "DeliverToContactPerson": null
, "DeliverToContactPersonFullName": null
, "DeliverToName": "             61602"
, "DeliveryDate": "\/Date(1591056000000)\/"
, "DeliveryStatus": 12
, "DeliveryStatusDescription": "Open"
, "DeliveryAddress": "bb8da22d-fd4f-4f8e-bd96-b0b1de61bd6a"
, "Description": "buy some items"
, "Division": 102673
...
, "InvoiceStatus": 12
, "InvoiceStatusDescription": "Open"
, "InvoiceTo": "6d0bfbeb-730f-4290-b886-007392d22a0f"
...
, "OrderedBy": "6d0bfbeb-730f-4290-b886-007392d22a0f"
...
, "OrderNumber": 42
...
, "Status": 12
, "StatusDescription": "Open"
...
, "SalesOrderLines": 
{
"__deferred": {
"uri": "https://start.exactonline.nl/api/v1/102673/salesorder/SalesOrders(guid'94feaad3-69cc-46ad-9925-d02d2b7f994a')/SalesOrderLines"
}
}
}
}

Tabeller som stöds

För följande Exact Online-tabeller är det möjligt att utföra transaktioner som kombinerar rader och huvuden till en enda transaktion:

Om Exact Online lägger till nya tabeller med transaktionslogik men din release ännu inte stöder dem, använd NativeScalarRequests för att ladda upp till dessa nya tabeller (för ett exempel, se Triggering the new error rate limit active of 10 per app, endpoint, Exact Online division, user and hour).

Prestanda vid uppladdning till Exact Online

Prestandan för Exact Online REST API är begränsad. Historiska mätningar finns dokumenterade i Does Invantive UniversalSQL match the speed of Infinite Probability Drive?. För uppladdningar med stora volymer är det ofta önskvärt att istället använda Exact Online XML API. Standarduppladdningar med Exact Online XML API finns tillgängliga på

Relevanta artiklar är:

Tabellen UploadXMLTopics i Invantive SQL delar automatiskt upp uppladdningen i hanterbara delar inom begränsningarna för Exact Online API, men med betydligt högre genomströmning än vid användning av Exact Online REST API:erna.