Twinfield: veelvoorkomende fouten

Deze pagina helpt bij fouten die je in de activiteit van Twinfield ziet. Je opent haar met Hulp bij deze fout. Zoek de melding en volg de stappen.

Gaat het om inloggen in het algemeen, een gepauzeerde of gestopte flow, of opnieuw proberen? Zie dan Verbinding of inloggen mislukt, Flow gepauzeerd of gestopt en Mislukte records en opnieuw proberen.

Fouten van APIcenter

The following fields are required and need to be present in the data

Oorzaak: In de gegevens van de order of klant ontbreekt een verplicht veld. De melding noemt de velden die ontbreken. Bij Twinfield gaat het om deze velden:

• header.invoicedate: de factuurdatum van de order.
• dimension.billingaddress.email: het e-mailadres van de klant. Dit is nodig voor het zoeken van de klant.
• Bij een financiële mutatie ook de rekeningen, zoals SettingValues.LedgerRevenueAccount (omzet) en SettingValues.LedgerDebtorAccount (debiteuren). Afhankelijk van de gekozen methode komen daar btw, verzendkosten en korting bij.

Oplossing:

1. Vul het ontbrekende gegeven in de bronapplicatie in, of controleer onder Data mapping van de flow dat het aan het juiste veld is gekoppeld.
2. Ontbreekt een rekening bij een financiële mutatie? Vul die in bij de instellingen van de flow. Zie Verkooporders naar Twinfield sturen.
3. Probeer de order of klant opnieuw.

Found multiple contacts with the same email!

Oorzaak: APIcenter zoekt de klant in Twinfield op e-mailadres. Vindt Twinfield meer dan één debiteur met dat e-mailadres, dan kan APIcenter de klant niet aan de order koppelen.

Oplossing:

1. Zoek in Twinfield de debiteuren met dit e-mailadres.
2. Zorg dat het e-mailadres bij één debiteur staat.
3. Probeer de order of klant opnieuw.

Failed to create customer with email

Oorzaak: Twinfield heeft de klant niet aangemaakt. Twinfield geeft daarbij een resultaat terug dat niet gelukt is.

Oplossing:

1. Open de activiteit en lees de melding van Twinfield.
2. Vul het gegeven dat Twinfield noemt aan in de bronapplicatie, of controleer de koppeling onder Data mapping van de flow Klanten naar Twinfield sturen.
3. Probeer de klant opnieuw.

Failed to create Customer, Failed to create SaleInvoice of Failed to create Invoice

Oorzaak: Twinfield heeft de klant, de factuur of de boeking geweigerd. Twinfield geeft het volledige bericht mee in de activiteit.

Oplossing:

1. Open de activiteit en lees de melding van Twinfield.
2. Controleer of de instellingen kloppen die bij de melding horen, zoals Order type (bestaat dit factuurtype of deze code in Twinfield?) en Company ID. Zie Verkooporders naar Twinfield sturen.
3. Controleer bij een financiële mutatie of de grootboekrekeningen in Twinfield bestaan.
4. Probeer de order opnieuw.

Not all required settings are present

Oorzaak: Een instelling die de flow nodig heeft, is niet beschikbaar in de integratie of de flow. Bij Twinfield controleert APIcenter Order type (factuur en financiële mutatie) en Default currency prices (financiële mutatie).

Oplossing: Neem contact op met de support van APIcenter om de instelling te laten activeren en probeer het daarna opnieuw.

The following fields need to be present in every element of the array: 'lines.line'

Oorzaak: Bij de methode Grouped heeft elke orderregel een btw-code (vatcode) nodig. Zonder btw-code kan APIcenter de regels niet groeperen. De melding noemt het veld dat ontbreekt.

Oplossing:

1. Controleer dat elke orderregel in de bronapplicatie een btw-code heeft.
2. Controleer onder Data mapping dat de btw-code aan het juiste veld is gekoppeld.
3. Kies anders een andere methode bij Use financial mutation method.

Fouten bij inloggen

De test van de verbinding mislukt

Oorzaak: Testverbinding vraagt de administraties (offices) op bij Twinfield. Geeft Twinfield er geen terug, dan is de test mislukt, bijvoorbeeld omdat het toegangstoken niet meer geldig is of de gebruiker geen toegang heeft.

Oplossing:

1. Controleer in Twinfield of je kunt inloggen met dezelfde gebruiker en of die bij een administratie kan.
2. Controleer de verbinding en de instelling Company ID. Zie Twinfield koppelen aan APIcenter.
3. Klik opnieuw op Testverbinding. Zie ook Verbinding of inloggen mislukt.

invalid_request of invalid_grant bij het vernieuwen van het token

Oorzaak: Twinfield geeft deze fouten bij het vernieuwen van een toegangstoken. Volgens de documentatie van Twinfield geeft invalid_request onder andere aan dat de organisatie niet actief of verwijderd is, of dat de gebruiker is verwijderd, uitgeschakeld of geblokkeerd is of dat het wachtwoord van de gebruiker is verlopen. invalid_grant geeft onder andere aan dat het vernieuwingstoken ongeldig of verlopen is.

Oplossing:

1. Controleer in Twinfield of de organisatie actief is en of de gebruiker kan inloggen met een geldig wachtwoord.
2. Los de situatie in Twinfield op, bijvoorbeeld door de gebruiker te laten deblokkeren of het wachtwoord te vernieuwen.
3. Autoriseer de Twinfield-verbinding opnieuw en klik op Testverbinding. Zie Verbinding of inloggen mislukt.

Meer over inloggen bij Twinfield staat in de documentatie van de Twinfield API.