From f37e091312a01c76eb243b7a3bbd333687a5c415 Mon Sep 17 00:00:00 2001 From: Tom Klute Date: Thu, 8 Oct 2026 15:59:36 +0200 Subject: [PATCH 1/2] Add GET connector import via cmdconnector to remotecmd how-to --- markdownpages/profit/en/howto-remotecmd.md | 50 ++++++++++++++++++++++ markdownpages/profit/nl/howto-remotecmd.md | 50 ++++++++++++++++++++++ 2 files changed, 100 insertions(+) diff --git a/markdownpages/profit/en/howto-remotecmd.md b/markdownpages/profit/en/howto-remotecmd.md index cc359a9..f8750e2 100644 --- a/markdownpages/profit/en/howto-remotecmd.md +++ b/markdownpages/profit/en/howto-remotecmd.md @@ -78,6 +78,56 @@ The response contains the `commandId` that you need to request the status of the ``` +## Importing a GET connector + +Besides data, you can also use the command connector to import the definition of a GET connector. This works the same way as an import, but with a different command line and a different file in the `` element. + +### Command line + +Use the `DEFINITIEIMPORT` action and provide the file name of the GET connector: + +``` +/O"O12345AA" DEFINITIEIMPORT /F".gcn" +``` + +### Definition file + +Provide the definition as a base64-encoded ZIP in the `` element. The ZIP contains: + +- the GET connector file (`.gcn`); +- an `@#$MetaInfo.xml` file containing the file name of the GET connector. + +The `@#$MetaInfo.xml` file has the following content: + +```xml +.gcn +``` + +The file name in the command line must match the name of the `.gcn` file in the ZIP. + +### Example + +```bash +curl -X POST "https://12345.soap.afas.online/profitservices/cmdconnector.asmx" \ + -H "Authorization: Bearer ..." \ + -H "Content-Type: text/xml; charset=utf-8" \ + -H "SOAPAction: urn:Afas.Profit.Services/Execute" \ + -d ' + + + + nit + /O"O12345AA" DEFINITIEIMPORT /F"SI_Verkooprelaties.gcn" + UEsDBBQACAAIAGJbSF0AAAAAAAAAAAAAAAAPACAAQCMkTWV0YUluZm8ueG1s... + + + ' +``` + +### Response + +As with an import, the response contains the `commandId` that you can use to request the status of the command. See [Requesting the status](#requesting-the-status). + ## Requesting the status To request the status of a previously executed command, use the `GetState` command. Provide the `commandId` that you received in the response to the `Execute` command. diff --git a/markdownpages/profit/nl/howto-remotecmd.md b/markdownpages/profit/nl/howto-remotecmd.md index 76abf61..b028f6e 100644 --- a/markdownpages/profit/nl/howto-remotecmd.md +++ b/markdownpages/profit/nl/howto-remotecmd.md @@ -78,6 +78,56 @@ In het response zie je de `commandId` terug die je nodig hebt om de status van d ``` +## GET-connector importeren + +Naast gegevens kun je via de cmdconnector ook de definitie van een GET-connector importeren. Dit werkt op dezelfde manier als een import, maar met een andere opdrachtregel en een ander bestand in het ``-element. + +### Opdrachtregel + +Gebruik de actie `DEFINITIEIMPORT` en geef de bestandsnaam van de GET-connector mee: + +``` +/O"O12345AA" DEFINITIEIMPORT /F".gcn" +``` + +### Definitiebestand + +De definitie lever je aan als een base64-gecodeerde ZIP in het ``-element. De ZIP bevat: + +- het GET-connectorbestand (`.gcn`); +- een `@#$MetaInfo.xml`-bestand met daarin de bestandsnaam van de GET-connector. + +Het `@#$MetaInfo.xml`-bestand heeft de volgende inhoud: + +```xml +.gcn +``` + +De bestandsnaam in de opdrachtregel moet overeenkomen met de naam van het `.gcn`-bestand in de ZIP. + +### Voorbeeld + +```bash +curl -X POST "https://12345.soap.afas.online/profitservices/cmdconnector.asmx" \ + -H "Authorization: Bearer ..." \ + -H "Content-Type: text/xml; charset=utf-8" \ + -H "SOAPAction: urn:Afas.Profit.Services/Execute" \ + -d ' + + + + nit + /O"O12345AA" DEFINITIEIMPORT /F"SI_Verkooprelaties.gcn" + UEsDBBQACAAIAGJbSF0AAAAAAAAAAAAAAAAPACAAQCMkTWV0YUluZm8ueG1s... + + + ' +``` + +### Response + +Het response bevat, net als bij een import, de `commandId` waarmee je de status van de opdracht kunt opvragen. Zie [Status opvragen](#status-opvragen). + ## Status opvragen Om de status van een eerder uitgevoerde opdracht op te vragen, gebruik je het `GetState`-commando. Hierbij geef je het `commandId` mee dat je hebt ontvangen in het response van de `Execute`-opdracht. From 0751037e965cda84cc2e9a9591996d6bd8a33e91 Mon Sep 17 00:00:00 2001 From: Tom Klute Date: Thu, 8 Oct 2026 16:03:13 +0200 Subject: [PATCH 2/2] Update date in AFAS Remote API documentation to reflect the latest revision --- markdownpages/profit/en/howto-remotecmd.md | 2 +- markdownpages/profit/nl/howto-remotecmd.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/markdownpages/profit/en/howto-remotecmd.md b/markdownpages/profit/en/howto-remotecmd.md index f8750e2..1204a32 100644 --- a/markdownpages/profit/en/howto-remotecmd.md +++ b/markdownpages/profit/en/howto-remotecmd.md @@ -1,7 +1,7 @@ --- title: AFAS Remote via the API author: EZW -date: 2026-09-14 +date: 2026-10-08 tags: API, Remote, Import --- diff --git a/markdownpages/profit/nl/howto-remotecmd.md b/markdownpages/profit/nl/howto-remotecmd.md index b028f6e..e304163 100644 --- a/markdownpages/profit/nl/howto-remotecmd.md +++ b/markdownpages/profit/nl/howto-remotecmd.md @@ -1,7 +1,7 @@ --- title: AFAS Remote via de API author: EZW -date: 2026-09-14 +date: 2026-10-08 tags: API, Remote, Import ---