Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions MarkdownPages/Endpoint/en/KnOrganisation_post.md
Original file line number Diff line number Diff line change
@@ -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).
19 changes: 18 additions & 1 deletion MarkdownPages/Endpoint/en/KnPerson_post.md
Original file line number Diff line number Diff line change
@@ -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
22 changes: 22 additions & 0 deletions MarkdownPages/Endpoint/nl/KnOrganisation_post.md
Original file line number Diff line number Diff line change
@@ -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).
22 changes: 20 additions & 2 deletions MarkdownPages/Endpoint/nl/KnPerson_post.md
Original file line number Diff line number Diff line change
@@ -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.
4 changes: 2 additions & 2 deletions MarkdownPages/Profit/en/News-profit6.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down
3 changes: 2 additions & 1 deletion MarkdownPages/Profit/nl/News-profit6.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down