SEPA-incassomachtigingen toevoegen, wijzigen en verwijderen (UpdateConnector FiSepaDirectDebit)

UpdateConnector voor het toevoegen en wijzigen van SEPA-incassomachtigingen.

Naam UpdateConnector: FiSepaDirectDebit

Let op: 

AFAS biedt naast het Help Center twee platforms voor het testen van connectoren en het raadplegen van specificaties, namelijk AFAS Connect en API Docs.

Inhoud

Voorbereiding

Beschrijving

Mogelijke acties met de connector

INSERT

Records toevoegen

Een insert van een incassomachtiging mag alleen op een geldig IBAN nummer. Een geldig IBAN nummer is een bankrekeningnummer dat gekoppeld is bij de betreffende verkooprelatie.

Xml-voorbeeld downloaden

Xml-voorbeeld downloaden (afwijkende machtiging)

UPDATE

Records wijzigen

Een update van een incassomachtiging is alleen mogelijk wanneer ‘vergelijken op’ en ‘vergelijken op kenmerk’ één resultaat oplevert. In het meest uitzonderlijke geval is voor het vinden van de juiste machtiging het IBAN nummer en kenmerk machtiging benodigd.

Xml-voorbeeld downloaden

DELETE

Records verwijderen

In de eigenschappen van de debiteur moet een gekoppelde bankrekening aanwezig zijn op het tabblad Betaling.

Xml-voorbeeld downloaden

Aandachtspunten:

  • Bij het toevoegen van een machtiging via de UpdateConnector kun je een kenmerk opgeven in de xml in het veld 'PaId'. Als dit veld niet gevuld is, bepaalt Profit het kenmerk.

Wijzigingen vanaf Profit 2

In dit artikel is gave nieuwe functionaliteit verwerkt die beschikbaar is vanaf Profit 2.

Het veld Organisatie vergelijken op (ViSe) heeft een extra methode om te zoeken op een eerder verleende machtiging, namelijk op Machtigings-Id (waarde 8). Je geeft het nummer dat je zoekt op in het veld Vergelijken op (Ds). De werking is als volgt:

  • Wijzigen van een machtiging via UPDATE/PUT

    Als het nummer bestaat, dan kun je de volgende velden wijzigen. Dit zijn dezelfde velden die je kunt wijzigen in het eigenschappenscherm. Op een SEPA-machtiging zijn geen vrije velden mogelijk.

    • Kenmerk machtiging (PaId)
    • Datum incassomachtiging (AuDa)
    • Code aanlevering transactie (VaDc)
    • Status machtiging (VaDs)
    • Administratie incassant-Id (oud) (CrOl)
    • Kenmerk machtiging (oud) (PaOl)
    • Administratienaam (oud) (NmOl)

    Let op:

    De aanpassingen gelden voor alle UPDATE/PUT-aanroepen! Voorheen was het mogelijk om een veld aan te passen via de connector, terwijl dat via het scherm niet mogelijk was. Dat werkt nu niet meer. Er komt geen foutmelding; de waarde die in het veld wordt ingestuurd wordt gewoon genegeerd.

Response bij een nieuw record

Als een nieuwe SEPA-machtiging is aangemaakt via de UpdateConnector, krijg je een response met het Machtigings-Id. Hieronder zie je een voorbeeld van een response:

{ "results": { "FiSepaDirectDebit": { "Id": "256" } }}

Direct naar

  1. UpdateConnector beschrijvingen