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
- De native-anropen loggas som standard i mappen
%USERPROFILE%\\invantive\\nativelog. - Starta en transaktion för att skapa försäljningsordern:
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:
ExactOnlineREST.CRM.QuotationsExactOnlineREST.FinancialTransaction.BankEntriesExactOnlineREST.FinancialTransaction.CashEntriesExactOnlineREST.FinancialTransaction.TransactionsExactOnlineREST.GeneralJournalEntry.GeneralJournalEntriesExactOnlineREST.Inventory.StockCountsExactOnlineREST.Inventory.WarehouseTransfers(från och med release 20.2.112)ExactOnlineREST.PurchaseEntry.PurchaseEntriesExactOnlineREST.Purchase.PurchaseInvoicesExactOnlineREST.PurchaseOrder.GoodsReceiptsExactOnlineREST.PurchaseOrder.PurchaseOrdersExactOnlineREST.SalesEntry.SalesEntriesExactOnlineREST.SalesInvoice.SalesInvoicesExactOnlineREST.SalesOrder.GoodsDeliveriesExactOnlineREST.SalesOrder.SalesOrdersExactOnlineREST.Subscription.Subscriptions
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:
- Mass copy pictures across Exact Online articles
- Upload Journal Entries to Exact Online
- Inlezen extra velden van Exact Online artikelen (nederländska)
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.
