diff --git a/MarkdownPages/Endpoint/en/KnOrganisation_post.md b/MarkdownPages/Endpoint/en/KnOrganisation_post.md new file mode 100644 index 0000000..bfa2c70 --- /dev/null +++ b/MarkdownPages/Endpoint/en/KnOrganisation_post.md @@ -0,0 +1,22 @@ +# KnOrganisation + +Create or modify an organisation. Available as a standalone UpdateConnector, but also as a sub-object in, among others, KnSalesRelationOrg. The functionality is nearly identical in both situations. + +None of the sub-objects of this UpdateConnector support supplying multiple lines. So, for example, to add multiple bank accounts, multiple calls will need to be made. + +## KnBasicAddressAdr + +An address that you enter is matched against a potentially existing address in Profit. This ensures that an address appears only once in the database. + +## KnBasicAddressPad + +Postal address. If the checkbox `PadAdr` has the value `true`, this sub-object is ignored. +An address that you enter is matched against a potentially existing address in Profit. This ensures that an address appears only once in the database. + +## KnBankAccount + +Only POST (Insert) is allowed on this sub-object + +## KnPerson + +See the description at [KnPerson](KnPerson_post.md). diff --git a/MarkdownPages/Endpoint/en/KnPerson_post.md b/MarkdownPages/Endpoint/en/KnPerson_post.md index 2ddf309..e3acbc9 100644 --- a/MarkdownPages/Endpoint/en/KnPerson_post.md +++ b/MarkdownPages/Endpoint/en/KnPerson_post.md @@ -1,5 +1,22 @@ # KnPerson -Create or modify a person. Available as a standalone UpdateConnector, but also as a sub-object in, among others, KnEmployee. The functionality is nearly identical in both situations. +Create or modify a person. Available as a standalone UpdateConnector, but also as a sub-object in, among others, [KnOrganisation](KnOrganisation_post.md) and KnEmployee. The functionality is nearly identical in all situations. None of the sub-objects of this UpdateConnector support supplying multiple lines. So, for example, to add multiple bank accounts, multiple calls will need to be made. + +## KnBasicAddressAdr + +An address that you enter is matched against a potentially existing address in Profit. This ensures that an address appears only once in the database. + +## KnBasicAddressPad + +Postal address. If the checkbox `PadAdr` has the value `true`, this sub-object is ignored. +An address that you enter is matched against a potentially existing address in Profit. This ensures that an address appears only once in the database. + +## KnContactAutRole + +Only POST (Insert) is allowed on this sub-object + +## KnBankAccount + +Only POST (Insert) is allowed on this sub-object diff --git a/MarkdownPages/Endpoint/nl/KnOrganisation_post.md b/MarkdownPages/Endpoint/nl/KnOrganisation_post.md new file mode 100644 index 0000000..c4d343e --- /dev/null +++ b/MarkdownPages/Endpoint/nl/KnOrganisation_post.md @@ -0,0 +1,22 @@ +# KnOrganisation + +Aanmaken of aanpassen van een organisatie. Beschikbaar als losse UpdateConnector, maar ook als subobject bij onder andere KnSalesRelationOrg. De werking is in beide situaties nagenoeg identiek. + +De subobjecten van deze UpdateConnector ondersteunen geen van alle het aanleveren van meerdere regels. Dus bijvoorbeeld voor het toevoegen van meerdere bankrekeningen zullen er meerdere calls gedaan moeten worden. + +## KnBasicAddressAdr + +Een adres dat je invoert wordt gematcht op een eventueel al bestaand adres in Profit. Daardoor komt een adres altijd maar één keer voor in de database. + +## KnBasicAddressPad + +Postadres. Als het vinkje `PadAdr` de waarde `true` heeft, wordt dit subobject genegeerd. +Een adres dat je invoert wordt gematcht op een eventueel al bestaand adres in Profit. Daardoor komt een adres altijd maar één keer voor in de database. + +## KnBankAccount + +Enkel POST (Insert) is toegestaan op dit subobject + +## KnPerson + +Zie de beschrijving bij [KnPerson](KnPerson_post.md). diff --git a/MarkdownPages/Endpoint/nl/KnPerson_post.md b/MarkdownPages/Endpoint/nl/KnPerson_post.md index 8a7b468..9b57966 100644 --- a/MarkdownPages/Endpoint/nl/KnPerson_post.md +++ b/MarkdownPages/Endpoint/nl/KnPerson_post.md @@ -1,5 +1,23 @@ # KnPerson -Aanmaken of aanpassen van een persoon. Beschikbaar als losse UpdateConnector, maar ook als subobject bij onder andere KnEmployee. De werking is in beide situaties nagenoeg identiek. +Aanmaken of aanpassen van een persoon. Beschikbaar als losse UpdateConnector, maar ook als subobject bij onder andere [KnOrganisation](KnOrganisation_post.md) en KnEmployee. De werking is in alle situaties nagenoeg identiek. + +De subobjecten van deze UpdateConnector ondersteunen geen van alle het aanleveren van meerdere regels. Dus bijvoorbeeld voor het toevoegen van meerdere bankrekeningen zullen er meerdere calls gedaan moeten worden. + +## KnBasicAddressAdr + +Een adres dat je invoert wordt gematcht op een eventueel al bestaand adres in Profit. Daardoor komt een adres altijd maar één keer voor in de database. + +## KnBasicAddressPad + +Postadres. Als het vinkje `PadAdr` de waarde `true` heeft, wordt dit subobject genegeerd. +Een adres dat je invoert wordt gematcht op een eventueel al bestaand adres in Profit. Daardoor komt een adres altijd maar één keer voor in de database. + +## KnContactAutRole + +Enkel POST (Insert) is toegestaan op dit subobject + +## KnBankAccount + +Enkel POST (Insert) is toegestaan op dit subobject -De subobjecten van deze UpdateConnector ondersteunen geen van alle het aanleveren van meerdere regels. Dus bijvoorbeeld voor het toevoegen van meerdere bankrekeningen zullen er meerdere calls gedaan moeten worden. \ No newline at end of file diff --git a/MarkdownPages/Profit/en/App-connector-auditor.md b/MarkdownPages/Profit/en/AppConnectorAuditor.md similarity index 100% rename from MarkdownPages/Profit/en/App-connector-auditor.md rename to MarkdownPages/Profit/en/AppConnectorAuditor.md diff --git a/MarkdownPages/Profit/en/App-connector-auditor-afas.md b/MarkdownPages/Profit/en/AppConnectorAuditorAFAS.md similarity index 100% rename from MarkdownPages/Profit/en/App-connector-auditor-afas.md rename to MarkdownPages/Profit/en/AppConnectorAuditorAFAS.md diff --git a/MarkdownPages/Profit/en/App-connector-auditor-partner.md b/MarkdownPages/Profit/en/AppConnectorAuditorPartner.md similarity index 100% rename from MarkdownPages/Profit/en/App-connector-auditor-partner.md rename to MarkdownPages/Profit/en/AppConnectorAuditorPartner.md diff --git a/MarkdownPages/Profit/en/News-profit6.md b/MarkdownPages/Profit/en/News-profit6.md index d7d8ad6..6c93677 100644 --- a/MarkdownPages/Profit/en/News-profit6.md +++ b/MarkdownPages/Profit/en/News-profit6.md @@ -13,9 +13,9 @@ Starting with Profit 6, a number of changes have been made to the AFAS Profit AP ### Always send AFAS token in base64-encoded format -Starting with Profit 6, it is mandatory to send the AFAS token in Base64 format via the Authorization HTTP header when calling the AFAS API (REST and SOAP). More information can be found in the [Help Center](https://help.afas.nl/help/EN/SE/App_Cnr_Rest_Call.htm). +Starting with Profit 6, it is mandatory to send the AFAS token in Base64 format via the Authorization HTTP header when calling the AFAS API (REST and SOAP). More information can be found in the [Help Center](https://help.afas.nl/help/EN/SE/App_Cnr_Rest_Call.htm). -This method has been recommended by AFAS for a long time, but it has become mandatory starting with Profit 6. If you send the token in an incorrect format (usually plain text) after transitioning to Profit 6, it will result in a 500 error message. +This method has been recommended by AFAS for a long time, but with the introduction of Profit 6 we will start enforcing it. If you provide the token in the header as plain text, we will ask you to adjust the calls through targeted emails. Starting from the end of 2025, an incorrect call will result in an HTTP 500 status. For now, it is still possible to send the token in the Body of a SOAP message. This method is strongly discouraged and will be phased out over time. diff --git a/MarkdownPages/Profit/nl/App-connector-auditor.md b/MarkdownPages/Profit/nl/AppConnectorAuditor.md similarity index 100% rename from MarkdownPages/Profit/nl/App-connector-auditor.md rename to MarkdownPages/Profit/nl/AppConnectorAuditor.md diff --git a/MarkdownPages/Profit/nl/App-connector-auditor-afas.md b/MarkdownPages/Profit/nl/AppConnectorAuditorAFAS.md similarity index 100% rename from MarkdownPages/Profit/nl/App-connector-auditor-afas.md rename to MarkdownPages/Profit/nl/AppConnectorAuditorAFAS.md diff --git a/MarkdownPages/Profit/nl/App-connector-auditor-partner.md b/MarkdownPages/Profit/nl/AppConnectorAuditorPartner.md similarity index 100% rename from MarkdownPages/Profit/nl/App-connector-auditor-partner.md rename to MarkdownPages/Profit/nl/AppConnectorAuditorPartner.md diff --git a/MarkdownPages/Profit/nl/News-profit6.md b/MarkdownPages/Profit/nl/News-profit6.md index 814d337..2a6b997 100644 --- a/MarkdownPages/Profit/nl/News-profit6.md +++ b/MarkdownPages/Profit/nl/News-profit6.md @@ -15,10 +15,11 @@ Vanaf Profit 6 is er een aantal wijzigingen in de AFAS Profit API doorgevoerd. H Vanaf Profit 6 is het bij een aanroep van de AFAS Api (REST en SOAP) verplicht om de AFAS-token mee te geven in Base64-formaat via de Authorization HTTP-header. Je vindt hierover meer informatie in het [Help Center](https://help.afas.nl/help/NL/SE/App_Cnr_Rest_Call.htm). -Deze methode wordt al lange tijd aanbevolen door AFAS, maar is met ingang van Profit 6 verplicht geworden. Als je de token na de overgang op Profit 6 aanbiedt in een onjuist formaat (meestal is dit plain text) dan zal dit resulteren in een 500-foutmelding. +Deze methode wordt al lange tijd aanbevolen door AFAS, maar met ingang van Profit 6 zullen we erop gaan controleren. Als je de token in de header aanbiedt als platte tekst, zullen we je via gerichte e-mailings vragen om de aanroepen aan te passen. Vanaf eind 2025 zal een foutieve aanroep resulteren in een HTTP 500 status. Vooralsnog blijft het in een SOAP bericht ook mogelijk om de token mee te geven in de Body. Deze methode wordt sterk ontraden en zal op termijn worden afgeschaft. + ### obsolete: X-PROFIT-ERROR De REST server geeft een korte beschrijving van de foutmelding in de response header X-PROFIT-ERROR. Deze beschrijving is precies hetzelfde als wat in de response body in het veld **externalMessage** wordt gegeven.