Dit artikel illustreert hoe je een verkooporder met regels aanmaakt in Exact Online met behulp van de REST-gebaseerde tabellen.
Het aanmaken van verkooporders wordt over het algemeen aanbevolen via de Exact Online XML API’s, vanwege een ongeveer 3 keer betere doorvoersnelheid en een orde van grootte hogere dagelijkse quota. De XML API’s zijn te benaderen via UploadXMLTopics of https://go.invantive.eu/get-my-report met een Excel-blad als invoer. Meer tips vind je in de sectie Prestaties hieronder.
Instructies voor het aanmaken van verkooporders en verkooporderregels
Exact Online heeft de eigenaardigheid dat elke transactie minstens één regel moet bevatten, wat geldt voor verkooporders, verkoopfacturen en journaalposten. Een standaard insert-statement maakt echter alleen de header aan. Daarom moeten de header en de regels in één transactie naar Exact Online worden verzonden.
Invantive SQL biedt transactielogica om dit te realiseren. Dezelfde transactielogica wordt ook gebruikt voor andere connectoren, zoals bij het aanmaken van EDIFACT-bestanden.
Het uitvoeren van onderstaande Invantive SQL-statements zal een verkooporder aanmaken zoals:
Volg deze stappen om zo’n verkoop aan te maken:
- Kies het Exact Online-bedrijf:
use COMPANYNUMBER
- Schakel native call logging in als je de daadwerkelijke communicatie met Exact Online wilt volgen, met:
set trace-native-calls true
set log-native-calls-to-disk
- De native calls worden standaard gelogd in de map
%USERPROFILE%\\invantive\\nativelog. - Start een transactie om de verkooporders aan te maken:
begin transaction
- Definieer de inhoud van een verkooporder:
insert into exactonlinerest..salesorders
( orderedby
, description
)
--
-- Selecteer een willekeurige klant en definieer een transactie 'TRANSACTION1',
-- één per verkooporder.
-- Je kunt meerdere Exact Online verkooporders definiëren en uploaden
-- en ze in één Invantive SQL-transactie verzenden.
--
select act.id
, 'buy some items' description
from exactonlinerest..accounts act
where act.status = 'C'
limit 1
identified by 'TRANSACTION1'
- Voeg tien verkooporderregels toe aan de verkooporder, elk met een ander willekeurig geselecteerd 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'
- Geef de verkooporder en de bijbehorende verkooporderregels in één REST API-aanroep door aan Exact Online:
commit transaction
- Na de commit zal Exact Online eventuele validatiefouten teruggeven.
- De uitgaande native call die in de logmap te vinden is, zal er ongeveer zo uitzien (regeleinden toegevoegd voor leesbaarheid):
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}
]
}
- Het native antwoord van Exact Online, geïnterpreteerd door Invantive SQL, zal er ongeveer zo uitzien:
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"
}
}
}
}
Ondersteunde tabellen
Op de volgende Exact Online-tabellen is het mogelijk om transacties uit te voeren, waarbij regels en headers in één transactie worden gecombineerd:
ExactOnlineREST.CRM.QuotationsExactOnlineREST.FinancialTransaction.BankEntriesExactOnlineREST.FinancialTransaction.CashEntriesExactOnlineREST.FinancialTransaction.TransactionsExactOnlineREST.GeneralJournalEntry.GeneralJournalEntriesExactOnlineREST.Inventory.StockCountsExactOnlineREST.Inventory.WarehouseTransfers(vanaf release 20.2.112)ExactOnlineREST.PurchaseEntry.PurchaseEntriesExactOnlineREST.Purchase.PurchaseInvoicesExactOnlineREST.PurchaseOrder.GoodsReceiptsExactOnlineREST.PurchaseOrder.PurchaseOrdersExactOnlineREST.SalesEntry.SalesEntriesExactOnlineREST.SalesInvoice.SalesInvoicesExactOnlineREST.SalesOrder.GoodsDeliveriesExactOnlineREST.SalesOrder.SalesOrdersExactOnlineREST.Subscription.Subscriptions
Indien Exact Online nieuwe tabellen met transactielogica toevoegt, maar jouw release deze nog niet ondersteunt, gebruik dan NativeScalarRequests om naar deze nieuwe tabellen te uploaden (zie voor een voorbeeld Triggering the new error rate limit active of 10 per app, endpoint, Exact Online division, user and hour).
Prestaties van uploads naar Exact Online
De prestaties van de Exact Online REST API zijn beperkt. Historische metingen zijn gedocumenteerd op Does Invantive UniversalSQL match the speed of Infinite Probability Drive?. Voor uploads met grote volumes is het vaak wenselijk om in plaats daarvan de Exact Online XML API te gebruiken. Standaard uploads met de Exact Online XML API zijn beschikbaar op
Relevante artikelen zijn:
- Mass copy pictures across Exact Online articles
- Upload Journal Entries to Exact Online
- Inlezen extra velden van Exact Online artikelen (Nederlands)
De tabel UploadXMLTopics van Invantive SQL splitst de upload automatisch op in beheersbare stukken binnen de beperkingen van de Exact Online API, maar met een aanzienlijk hogere doorvoersnelheid dan bij gebruik van de Exact Online REST API’s.
