Pakbonnen toevoegen, wijzigen of verwijderen (UpdateConnector FbDeliveryNote)

UpdateConnector voor het toevoegen, wijzigen en verwijderen van pakbonnen.

Je kunt nieuwe pakbonnen toevoegen, of pakbonnen die gebaseerd zijn op in Profit vastgelegde verkooporders. Indien de pakbonnen gebaseerd worden op bestaande verkooporders, kunnen de gegevens van de oorspronkelijke orders eerst uit Profit worden opgehaald met behulp van een GetConnector. Je kunt verkooporders volledig leveren, of een deellevering leveren.

Naam UpdateConnector: FbDeliveryNote

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.

Voorbereiding

• Pakbon (algemene toelichting)

Beschrijving

Samenstellingen met artikelen met serienummers

Bij samenstellingen kun je bij een Insert serienummers toekennen aan de artikelen van de samenstellingen. Dit kan met de volgende UpdateConnectoren:

• FbDeliveryNote
• FbDirectInvoice
• FbSales
• FbSalesQuotation

Pakbonnen toevoegen

Bij het toevoegen van nieuwe pakbonnen gelden vrijwel geen beperkingen:

• Een pakbon met bijbehorende regels moet in één xml-bestand worden aangeleverd. De xml moet zowel de kopregel als de regels bevatten.
• Je kunt het pakbonnummer opgeven in het veld 'OrNu'. Zo niet, dan moet dit via autonummering worden bepaald.

Bij het toevoegen van pakbonnen op basis van bestaande verkooporders geldt het volgende:

• Een pakbon met bijbehorende regels moet in één xml-bestand worden aangeleverd. De xml moet zowel de kopregel als de regels bevatten.
• Je kunt het pakbonnummer opgeven in het veld 'OrNu'. Zo niet, dan moet dit via autonummering worden bepaald.
• Bij een pakbonregel op basis van een bestaande orderregel geef je het oorspronkelijke ordernummer op in het veld 'SoOr' en de regel-GUID van de oorspronkelijke regel in het veld 'SoGu'. Bij een nieuwe pakbonregel geldt dit niet.

  Door het ordernummer per regel aan te leveren is het mogelijk regels van verschillende orders te verzamelen op één pakbon.

• Je mag alleen de velden wijzigen die je ook kunt wijzigen als je handmatig een pakbon toevoegt.

  Let op:

  De overige velden kunnen wel worden aangeleverd aangezien ze in de XSD zitten. Ze kunnen daaruit niet worden weggelaten omdat ze wel worden gebruikt voor pakbonnen die niet gebaseerd zijn op een voorgaande order.

Pakbonnen wijzigen

Bij het wijzigen van een bestaande pakbonregel moet je de volgende velden opgeven:

• SoOr (orginele ordernummer)
• SoGu (GUID van de regel)

Retouren

Je kunt retouren boeken via de connectoren FbDeliveryNote / FbGoodsReceived. Gebruik hiervoor de tag <QuUn>. Wil je bijvoorbeeld één stuks retour boeken, dan wordt dit <QuUn>-1</QuUn>.

Verzamelen

Door het ordernummer per regel aan te leveren is het mogelijk regels van verschillende orders te verzamelen op een pakbon.

Gereedmelden

Je kunt pakbonnen gereedmelden. Stel hiervoor het veld RdDe (Gereedgemeld) in.

Let op:

Als je pakbonnen gereedmeldt en de Transsmart (nShift)-activatie staat aan, en de verzending naar Transsmart (nShift) gaat fout, dan komt er geen melding terug in de UpdateConnector.

CBS

• CBS Transactie aard code (VaTa)

De CBS Transactie aard code is in afgehandelde ontvangsten en pakbonnen muteerbaar, respectievelijk via de UpdateConnectoren FbGoodsReceived en FBDeliveryNote.

Aantallen

Voor de aantallen in de regels geldt:

• Van de te leveren artikelen moet voorraad aanwezig zijn.
• De aantallen zijn altijd de werkelijk geleverde aantallen. Deze aantallen worden dus altijd in de voorraad verwerkt als voorraad van het basic item wordt bijgehouden.
• Indien het aantal in de pakbonregel (in de xml) overeenkomt met het te leveren aantal in de oorspronkelijke orderregel, wordt de oorspronkelijke regel als afgehandeld beschouwd.
• Indien het aantal in de pakbonregel (in de xml) groter is dan het te leveren aantal in de oorspronkelijke orderregel, wordt de oorspronkelijke regel als afgehandeld beschouwd en wordt de eventuele reservering van het oorspronkelijke aantal verwerkt.
• Indien het aantal in de pakbonregel (in de xml) lager is dan het aantal in de oorspronkelijke orderregel, wordt de regel beschouwd als deellevering. De eventuele reservering van het oorspronkelijke aantal wordt verminderd met het aangeleverde aantal.
• Als alle regels van de oorspronkelijke order worden aangeleverd en alle oorspronkelijke orderregels als afgehandeld kunnen worden beschouwd, dan wordt bij de verwerking de oorspronkelijke order ook geheel afgehandeld. Als niet alle oorspronkelijke orderregels kunnen worden afgehandeld, wordt de oorspronkelijke order beschouwd als deels geleverd. De order kan dan wel achteraf worden afgehandeld met de daarvoor beschikbare actie in Profit.

  Let op:

  Als regels van de oorspronkelijke order niet worden aangeleverd of worden aangeleverd met een aantal van nul (0), worden deze regels beschouwd als nog te leveren. Indien gewenst kunnen orders met de functie Afhandelen order alsnog worden afgehandeld.

Controle op basic item

De door de Connector uitgevoerde controles komen overeen met de door Profit uitgevoerde controles bij handmatige invoer van een pakbon. Dat betekent dat alleen basic items mogen worden aangeleverd die ook bij handmatige invoer zijn toegestaan. Niet-toegestane basic items leiden tot een foutmelding; hierdoor wordt de pakbon afgewezen en niet aangemaakt.

Het is wel mogelijk om regels aan te leveren met een basic item waaraan verpakkingen zijn gekoppeld. Verpakkingsregels kunnen echter niet worden aangeleverd. De verpakkingsregels in de pakbon worden in dat geval altijd door Profit gegenereerd. Hetzelfde geldt voor samenstellingsregels die altijd gegenereerd worden op basis van de voorkeursamenstelling die bij het betreffende basic item is vastgelegd.

Basic items waarvoor geldt dat er serienummers, partijen of orderspecificaties van toepassing zijn, kunnen ook worden aangeleverd met de bijbehorende serienummers en partijnummers (segment 'FbOrderSerialLines', segment 'FbOrderBatchlines' voor zowel partijen als orderspecificaties). Voor orderspecificaties geldt dat het veld 'BaNu' gevuld moet worden met *****.

Pakbonnummer

Veld: OrNu

Je kunt het pakbonnummer aanleveren via de UpdateConnector. Als je dit niet doet, moet het pakbonnummer worden bepaald op basis van autonummering.

Afwijkende contactpersoon

Je kunt het veld Afwijkende contactpersoon (CtI1) leegmaken in de UpdateConnector door de waarde <CtI1 xsi:nil="true"/> mee te geven in je xml.

Pakbonnen met magazijnlocatie

Je kunt ook de magazijnlocatie van de artikelen meenemen in het segment 'FbOrderlocationLines' in de UpdateConnector voor de pakbonnen.

Dit is alleen relevant als je de functionaliteit Magazijnlocaties hebt geactiveerd.

Je kunt magazijnlocaties met aantallen toevoegen bij de volgende artikeltypen:

• Voorraadhoudende items (met uitzondering van partij-, serienummer- en orderspecificaties), subniveau onder de pakbonregel.
• Partijartikelen, subniveau onder de partijregel(s).
• Serienummerartikel, subniveau onder de serienummerregel(s).
• Orderspecificatie-artikel, subniveau onder de orderspecificatiepartijregel(s).

  Let op:

  Je moet aantallen in basiseenheden opgeven bij het gebruik van magazijnlocaties in UpdateConnectoren.

Het opgeven van locaties in de UpdateConnector is niet verplicht; als er geen locaties worden meegegeven deelt Profit zelf de locaties uit.