Alles over FPT

FPT: Voorraad naar FPT sturen

Bewaar voorraadregels en maak het exportbestand met voorraad en verkoopregels voor FPT, als zip-bestand op een FTP- of SFTP-server.

Bijgewerkt op 9 november 2026

Deze flow bewaart voorraadregels uit een andere applicatie en maakt het exportbestand voor FPT. Het bestand bevat de voorraad en de verkoopregels (sell-out), en APIcenter zet het op een FTP- of SFTP-server.

Zo werkt het

Deze flow heeft twee werkwijzen. Welke APIcenter gebruikt, hangt af van de export-instellingen.

Gewone run (export staat uit of is nog niet aan de beurt):

  • APIcenter bewaart elke voorraadregel per magazijn en sorteert ze op de datum van de regel. Er wordt nog geen bestand gemaakt.
  • Een regel met hetzelfde ID vervangt de eerdere regel met dat ID.
  • Elke regel heeft nodig: id, warehouseCode, date, partNumber, quantity en currencyCode. Mist er een, dan mislukt de run met een melding.

Export-run:

  • De export start als Enable the usage of a send export aanstaat en het moment bij Next date of the send export is bereikt. Staat er geen datum bij Next date of the send export, dan start de export niet.
  • APIcenter maakt dan een bestand met de dagexport. Daarna werkt het de datums en het volgnummer bij. Zie hieronder.
  • APIcenter maakt ook een bestand voor een aanvraag, als er in de aanvraagmap een nieuw aanvraagbestand staat.
  • Het bestand wordt als zip-bestand geüpload naar de map van de export. Binnen het zip-bestand staat een tekstbestand (.txt).
  • Gaat er tijdens de export iets mis, dan zet APIcenter Enable the usage of a send export automatisch uit en toont de fout in de activiteit.

De dagexport

  • APIcenter maakt per magazijncode uit Standard Warehouse Codes een blok met voorraadregels en een blok met verkoopregels. De blokken staan achter elkaar in één bestand.
  • De periode loopt van Previous date of the send export tot Next date of the send export. APIcenter neemt de records mee waarvan de datum in die periode valt.
  • Na de export zet APIcenter Previous date of the send export op het oude Next date of the send export en zet APIcenter Next date of the send export één dag later. Het volgnummer bij Progressive Transmission Number gaat met 1 omhoog.
  • De kopregel bevat de marktcode uit Default Market Code en de dealercode uit Default Dealer Code.

De aanvraag

  • Naast de dagexport kan een aanvraagbestand een export op afroep starten. Dit bestand staat in de tweede map van Folder of the send export.
  • APIcenter verwerkt per run één aanvraagbestand. Het aantal bestanden dat APIcenter per run ophaalt uit de map, stel je in met Maximum number of pages to retrieve.
  • Een aanvraagbestand dat verwerkt is, verwerkt APIcenter niet nog een keer.
  • Een export op afroep staat in de kopregel als "E", een dagexport als "G".

De verkoopregels in het bestand

  • De verkoopregels komen uit de verzendingen. Zie Verzendingen naar FPT sturen.
  • Staat een verzending in een factuur uit de flow Verkooporders naar FPT sturen, dan krijgt de regel het factuurnummer en de factuurdatum, en telt de hoeveelheid als gefactureerd. Zonder factuur is de gefactureerde hoeveelheid 0.
  • Verwijst een factuur in de periode naar een verzending die APIcenter niet in de periode heeft, dan haalt APIcenter die verzending erbij. Kan APIcenter de verzending niet vinden, dan mislukt de export.

Wat je eerst nodig hebt

  • FPT is gekoppeld. Zie FPT koppelen aan APIcenter.
  • De andere applicatie van de integratie kan voorraad versturen, met magazijncode en onderdeelnummer.
  • Standard Warehouse Codes, Progressive Transmission Number, Default Market Code en Default Dealer Code zijn ingevuld: dit zijn verplichte instellingen.

Tips

  • Komt er geen bestand? Controleer of Enable the usage of a send export aanstaat en of Next date of the send export een datum en tijd in het verleden heeft.
  • Zet Folder of the send export op twee mappen, gescheiden door een verticale streep: eerst de map voor de export, dan de map met aanvraagbestanden. Zie de uitleg van deze instelling.
  • Het bestand krijgt de naam uit Filename Format. De standaard is CSIIRSSP_{timestamp}.
  • Tekens in tekstvelden worden omgezet naar gewone letters en afgekapt op de lengte van het veld.

Hieronder vind je alle instellingen van deze flow, elk met een eigen uitleg.

Instellingen

De instellingen die je in het dashboard ziet, met wat elke instelling doet.

Bepaalt wat er gebeurt als een veld bij het mappen van de gegevens niet kan worden omgezet. Staat de instelling aan, dan stopt de flow met een foutmelding. Staat de instelling uit, dan gaat de flow verder en wordt dat veld overgeslagen. Standaard staat deze instelling aan.

Default Dealer Code

File Settings

Hier vul je de dealercode in. APIcenter zet deze code in de kopregel van elk blok in het exportbestand. APIcenter gebruikt de eerste 7 tekens. Deze instelling is verplicht en maakt geen XML.

Default Market Code

File Settings

Hier vul je de marktcode in. APIcenter zet deze code in de kopregel van elk blok in het exportbestand. APIcenter gebruikt de eerste 4 tekens. Deze instelling is verplicht en maakt geen XML.

Filename Format

File Settings

Bepaalt de naam van het exportbestand. Je kunt de sleutels {guid}, {timestamp} en {datetime} gebruiken. De standaardwaarde is CSIIRSSP_{timestamp}. APIcenter voegt .txt toe en zet het bestand in een zip-bestand met dezelfde naam, dus het geüploade bestand eindigt op .zip.

Dit is het volgnummer van het volgende exportbestand (progressive transmission number). APIcenter zet het in de kopregel en verhoogt het met 1 na elke dagexport. Een export op afroep gebruikt het nummer uit het aanvraagbestand. De standaardwaarde is 0. Deze instelling is verplicht.

Server Root

File Settings

Het hoofdpad op de FTP- of SFTP-server. De mappen in Folder of the send export gelden vanaf dit pad. Laat het veld leeg om vanaf de hoofdmap van de server te werken.

Standard Warehouse Codes

File Settings

Hier vul je de magazijncodes in, gescheiden door een komma. APIcenter maakt voor elke code een blok met voorraadregels en een blok met verkoopregels in het exportbestand van de dag. Het is hier dus geen scheidingsteken voor een CSV-bestand. Deze instelling is verplicht.

Hiermee codeer je de waarden in het adres (de URL) van de doelapplicatie, dus bij flows die gegevens versturen. Dit werkt alleen als Enable URL encoding of data in endpoints aanstaat. Standaard staat dit uit.

Zet dit aan als er speciale tekens in de data staan die in het adres (de URL) van een verzoek terechtkomen, zoals in een SKU of categorienaam. De waarden worden dan URL-gecodeerd, zodat het verzoek niet misgaat. Met Enable URL Encoding of data in the endpoints of the source application en Enable URL Encoding of data in the endpoints of the target application bepaal je voor welke kant dit geldt. Standaard staat dit uit.

Use administration mapping table

General flow setting

Zet dit aan om de administratie om te zetten met een koppeltabel tussen de twee applicaties. Wat er gebeurt met een waarde die niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat dit uit.

Hier kies je wat er gebeurt met een administratie die niet in de koppeltabel staat. Bij Waarde negeren wordt de waarde leeggelaten, bij Waarde gebruiken blijft de oorspronkelijke waarde staan en bij Standaardwaarde gebruiken wordt de standaardwaarde uit Default administration id gebruikt, als je die hebt ingeschakeld. Deze instelling werkt alleen als Use administration mapping table aanstaat. Standaard is Standaardwaarde gebruiken gekozen.

Vul hier het e-mailadres in waarnaar APIcenter meldingen stuurt over mislukte activiteiten van deze flow. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan gebruikt APIcenter bij Direct het e-mailadres van je account. Er is geen standaardwaarde.

Vul hier de Slack-webhook van je Slack-werkruimte in om meldingen over mislukte activiteiten ook in Slack te ontvangen. Dit werkt alleen als Receive Notifications aan staat. Laat je het veld leeg, dan stuurt APIcenter geen Slack-melding. Er is geen standaardwaarde.

Notifications frequency

Notifications

Kies hoe vaak APIcenter meldt dat activiteiten van deze flow zijn mislukt. Bij Direct volgt de melding zodra een activiteit mislukt. Bij Elke 30 minuten, Elk uur, Dagelijks en Wekelijks stuurt APIcenter een overzicht van de mislukte activiteiten die nog niet gemeld zijn. Dit werkt alleen als Receive Notifications aan staat. Standaard is dit Direct.

Receive Notifications

Notifications

Zet dit aan om een melding te krijgen als een activiteit van deze flow mislukt. Met Notifications frequency bepaal je hoe vaak je de melding krijgt, en met Notifications Email address en Notifications Slack webhook waar die naartoe gaat. Standaard staat dit uit.

Zet deze instelling aan om het exportbestand voor FPT te laten maken. Zonder deze instelling bewaart de flow alleen de gegevens. Gaat er tijdens een export iets mis, dan zet APIcenter de instelling automatisch uit. De standaardwaarde is uit.

Hier vul je twee mappen in, gescheiden door een verticale streep (|). De eerste map is de plek waar APIcenter het exportbestand neerzet. De tweede map is de plek waar APIcenter de aanvraagbestanden voor een export op afroep leest. Vul je maar één map in, dan werkt de export op afroep niet.

Hier stel je in hoeveel nieuwe aanvraagbestanden APIcenter per run uit de aanvraagmap ophaalt. Per run verwerkt APIcenter één aanvraagbestand. De standaardwaarde is 20.

Vanaf dit moment kan de volgende dagexport starten. De export start alleen als Enable the usage of a send export aanstaat. Zonder datum start de export niet. Na elke dagexport zet APIcenter deze datum één dag later. Dit is ook het einde van de periode van de export.

Dit is het begin van de periode van de volgende dagexport. APIcenter neemt de records mee waarvan de datum tussen deze datum en Next date of the send export valt. Na elke dagexport zet APIcenter deze datum zelf op het oude volgende moment.

Enable the use of a default warehouse

Stock & Warehouse Settings

Zet aan om een standaardmagazijn te gebruiken. APIcenter vult dan het magazijn in als de gegevens geen magazijn hebben. De waarde stel je in bij Value for the default warehouse id. Standaard staat de instelling uit.

Force the usage of the default warehouse

Stock & Warehouse Settings

Zet aan om altijd het standaardmagazijn te gebruiken, ook als de gegevens al een waarde hebben. Staat de instelling uit, dan gebruikt APIcenter de standaardwaarde alleen als de gegevens geen waarde hebben. Deze instelling hoort bij Enable the use of a default warehouse. Standaard staat hij uit.

Use warehouse mapping table

Stock & Warehouse Settings

Zet aan om de waarde van het magazijn om te zetten met een mappingtabel. APIcenter zoekt de waarde uit de gegevens op in de tabel. Wat er gebeurt als een waarde niet in de tabel staat, bepaal je met What to do with a value that cannot be mapped using the mapping table. Standaard staat de instelling uit.

Value for the default warehouse id

Stock & Warehouse Settings

Hier vul je het standaardmagazijn in. APIcenter zet deze waarde in het magazijnveld van het item (de magazijncode), als Enable the use of a default warehouse aan staat en de gegevens geen magazijn hebben. Met Force the usage of the default warehouse gebruikt APIcenter deze waarde ook als er wel een magazijn is.

Hiermee bepaal je wat er gebeurt met een magazijn die niet in de mappingtabel staat. Bij Waarde negeren wordt de waarde weggelaten. Bij Waarde gebruiken blijft de oorspronkelijke waarde staan. Bij Standaardwaarde gebruiken gebruikt APIcenter de standaardwaarde uit Value for the default warehouse id, als Enable the use of a default warehouse aan staat; anders blijft de waarde leeg. Standaard is dit Standaardwaarde gebruiken.

Nog vragen?

Stel je vraag aan de supportassistent in je dashboard of maak een supportticket aan.

Naar support