Integratie: FileMaker Add-on

De gemakkelijkste manier om ABCinvoice.eu te integreren met FileMaker is door de Add-on te gebruiken.

Deel 1 – Add-on instellen

Opmerkingen over deze documentatie:

• Er wordt aangenomen dat je al een factuurtabel hebt (hieronder “Facturen”), gekoppeld aan een factuurregels tabel (hieronder “Regels”).
• Als je meerdere vervaldatums in een aparte tabel beheert, wordt deze tabel hieronder “Vervaldatums” genoemd.

1. Download de add-on en pak het archief uit. [Downloaden]
2. Schakel in je oplossing over naar de lay-outmodus en installeer de add-on (+ in het Add-ons-tabblad van het linker paneel). Selecteer de add-on die je zojuist hebt uitgepakt.
3. Sleep de add-on naar een lay-out.
4. Maak een relatie tussen je Facturen-tabel en de ABCinvoice_Attachment-tabel met idInvoice als buitenlandse sleutel. (verbind de primaire sleutel van je Facturen-tabel met ABCinvoice_Attachment::idInvoice)
5. Maak een relatie tussen je Facturen-tabel en de ABCinvoice_LegalLiteral-tabel met idInvoice als buitenlandse sleutel. Vink het vakje aan om gerelateerde records vanuit Facturen te maken. De ABCinvoice_LegalLiteral-tabel stelt je in staat om juridische vermeldingen aan je facturen toe te voegen.
6. Optioneel: Kopieer de externe tabel van de ABCinvoice_LegalLiteral_Example-lay-out naar je Facturen-lay-out om het invoeren van verplichte vermeldingen te vergemakkelijken.
7. Optioneel: Kopieer de externe tabel van de ABCinvoice_Attachments_Example-lay-out naar je Facturen-lay-out.
8. Veldconfiguratie
   • Kopieer de velden van de ABCinvoice_invoiceExample-tabel naar je Facturen-tabel.
   • Kopieer het veld van de ABCinvoice_invoiceLineExample-tabel naar je Regels-tabel.
   • Vervaldatums (als je meerdere vervaldatums beheert): kopieer het veld van de ABCinvoice_InvoiceDueDateExample-tabel naar je Vervaldatums-tabel.
   • Wijzig de velden van ABCinvoice_JSONrepresentation_{tabel} in de Facturen, Regels en, als je meerdere vervaldatums beheert, de Vervaldatums-tabellen.
     • Opmerkingen over de configuratie van de JSONrepresentation-velden:
       • Datums worden als getallen doorgegeven om compatibiliteit tussen alle systemen (client/server…) te waarborgen. Bijvoorbeeld, de parameter dateAsNumber van ABC_invoice_JSONrepresentation_invoice moet worden doorgegeven als: GetAsNumber ( Factuur::factuurDatum )
       • Gelinkte gegevensarrays moeten als volgt worden doorgegeven: ;[ “invoiceLinesAttributes”; JSONMakeArray ( List ( Regels:: ΩABCinvoiceJSONrepresentation_invoiceLine ); ¶ ; JSONObject ); JSONArray ] Voor de vervaldatum(men) kun je:
         • Als je geen meerdere vervaldatums beheert, gebruik dan de parameter dueDateAsNumber.
         • Als je ze in een aparte tabel beheert, gebruik dan de parameter die in het voorbeeld wordt gegeven.
9. Configureer het ABCinvoice_Config-script
10. Instellingen
    • Maak een account aan op ABCinvoice en verkrijg een API-sleutel.
    • Voer vanuit de interface (de add-on die je naar de lay-out hebt gesleept) de API-sleutel en je land in (het land vanwaaruit de facturen worden uitgegeven). Werk de juridische vermeldingenbibliotheek bij door op Update legal literals te klikken.
11. Verwijder ongebruikte elementen die er alleen zijn om je te helpen bij de configuratie:
    • Tabellen die het woord Example bevatten en hun tabeloccurrences (ABCinvoice_InvoiceExample, ABCinvoice_InvoiceLineExample, ABCinvoice_DueDateExample).

Deel 2 – Je scripts aanpassen

Bijlagen: Alle documenten in de ABCinvoice_Attachment-tabel worden geüpload samen met je factuur.

WAARSCHUWING: Eenmaal geüpload kan een bijlage niet meer worden verwijderd! Je kunt bijlagen toevoegen zolang de factuur nog niet is verzonden.

• ttachment-tabel) met het script ABCinvoice_sample_AddAttachment met de parameters: idInvoice = de primaire sleutel van je Facturen-tabel en isInvoice = True.
• Sla andere documenten zoals Algemene Voorwaarden, saldo (klantsaldo), etc., op als bijlagen (ABCinvoice_attachment-tabel) met de parameters: idInvoice = de primaire sleutel van je Facturen-tabel en isInvoice = False.
• Verschillende voorbeeldscripts worden meegeleverd in de map “ABCinvoice – integratievoorbeeld”, zoals het script ABCinvoice_sample_CreateInvoice, dat een elektronische factuur maakt.
• Voeg eenvoudig de navigatie naar de te maken factuur toe in de sectie ———– FIND YOUR INVOICE ———–, en wijzig de optionele parameters indien nodig in de sectie ———–✏️ DEFINE OPTIONAL VALUES ———–. Je kunt de voorbeeldscripts dupliceren en aanpassen voor je behoeften.
• Wijzig de scripts in de map “ABCinvoice (private)” niet.
• De add-on wordt geleverd met waarde-lijsten om je te helpen. Al deze lijsten beginnen met ABCinvoice.

Deel 3 – Ontvangen Facturen

• Als je al een tabel voor inkomende facturen hebt.
  • Duplication et adaptation des scripts  “ABCinvoice_GetReceivedInvoices – Scheduled script” , “ABCinvoice_GetReceivedInvoicesDetails” , “ABCinvoice_Create_RINL (invoice)” , “ABCinvoice_Create_RDUEDATES (invoice)” et “ABCinvoice_Create_RTAX (invoice)”
• De lay-outs voor de lijst van inkomende facturen en het weergeven van hun details bevinden zich in de map “ReceivedInvoicesLayouts” van de add-on. De scripts voor het ophalen van inkomende facturen zijn ook inbegrepen en vereisen geen wijziging van je kant als je geen inkomende facturen-tabel hebt.

Deel 4 – Voorbeeld Lay-outs

• Twee voorbeeld lay-outs worden meegeleverd met kant-en-klare externe tabellen voor je eigen lay-outs: ABCinvoice_Legal_Example voor juridische vermeldingen, ABCinvoice_Attachment_Example voor bijlagen. Je kunt deze externe tabellen kopiëren en indien nodig aanpassen.