CreateInkoopfactuur

Met de functie CreateInkoopfactuur kun je inkoopfacturen van bestaande inkooporders inboeken (vanaf versie 4.3.9a).

CreateInkoopfactuur(ByVal PartnerKey As String, ByVal Omgevingscode As String, ByVal SessionId As String, ByRef Inkoopfactuur As DataSet, ByRef INKFACTNR As string, ByRef foutmelding As String) As Boolean

Inkoopfactuur (INKFACTNR) is een character veld. (String) Bij het boeken van inkoopfacturen dient de inkooporder te bestaan.

SOAP REQUEST

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
 <soap12:Body>
 <CreateInkoopfactuur xmlns="https://cloudswitch.imuisonline.com/">
 <PartnerKey>string</PartnerKey>
 <Omgevingscode>string</Omgevingscode>
 <SessionId>string</SessionId>
 <Inkoopfactuur><![CDATA[zie voorbeeld]]></Inkoopfactuur>
 <INKFACTNR>txt</INKFACTNR>
 <Foutmelding>string</Foutmelding>
 </CreateInkoopfactuur>
 </soap12:Body>
</soap12:Envelope>


VOORBEELD BOEKEN INKOOPFACTUUR
Informatie over request  tag <Inkoopfactuur></Inkoopfactuur>, bij het boeken van de inkoopfactuur. Voor het boeken van een inkoopfactuur maken we gebruik van een tweetal tabellen: IFCBK en INKRG. In de tabel IFCBK geven we de informatie op die voor de gehele factuur gelden. In de tabel INKRG staan de inkooporderregels die moeten worden geboekt.

<NewDataSet>
<IFCBK>
<CRE>nummer crediteur</CRE>
<DATFACT>Datum van inkoopfactuur</DATFACT>
<JRFACT>Jaar van inkoopfactuur</JRFACT>
<PNFACT>Periode van inkoopfactuur</PNFACT>
<BOEKSTUK>Boekstuknummer</BOEKSTUK>
<KENMFACT>Kennmerk van inkoopfactuur</KENMFACT>
<OMSCHR>Omschrijving van inkoopfactuur</OMSCHR>
<OPMFACT>Opmerking van inkoopfactuur</OPMFACT>
<BETWIST>Inkoopfactuur is betwist (J/N)</BETWIST>
<KPL>Kostenplaats van inkoopfactuur</KPL>
<KDR>Kostendrager van inkoopfactuur</KDR>
<BETCOND>Betalingsconditie van inkoopfactuur</BETCOND>
<LEVCOND>Leverconditie van inkoopfactuur</LEVCOND>
</IFCBK>
<INKRG>
<ORDNR>Inkoopordernummer</ORDNR>
<RG>Regelnummer</RG>
<ART>Artikelnummer</ART>
<OPFACTUUR>Aantal op de inkoopfactuur</OPFACTUUR>
<PRSFACT>Prijs perstuk op de inkoopfactuur</PRSFACT>
<PERCKORTFACT>Korting percentage op de inkoopfactuur</PERCKORTFACT>
</INKRG>
</NewDataSet>

Optioneel: er kan een datatable <DIGDOS><FILE>byte array (.NET), of base64 encoded string (XML en HTTP-API)</FILE></DIGDOS> worden toegevoegd. Hiermee worden dossierstukken toegevoegd aan de inkooporder.

In de IFCBK-tag kunnen een aantal additionele velden worden gebruikt voor speciale acties.  Naast de velden: CRE, DATFACT, DATVERV, JRFACT, PNFACT, BOEKSTUK, KENMFACT, OMSCHR, OPMFACT, BETWIST, KPL, KDR, BETCOND en LEVCOND. Kunnen de er extra velden worden gebruikt voor extra kosten zoals vracht- en orderkosten, kredietbeperking, betalingskorting en/of emballage. Dit zijn de velden: BEDRORDKST, BEDRVRACHTKST, BEDRKB, BEDRBETKORT en BEDREMBALLAGE.

Voor verschillende additionele kortingen over de gehele factuur kan per BTW-soort een korting worden doorgegeven, via de velden: BEDRKORTHOOG, BEDRKORTLAAG, BEDRKORTGEEN, BEDRKORTBINEU, BEDRKORTBINEULAA, BEDRKORTBINEUGEE, BEDRKORTBUIEU, BEDRKORTBUIEULAA, BEDRKORTBUIEUGEE, BEDRKORTVERLEGD. De keuze voor de velden is aan de ontwikkelaar en is afhankelijk van de Btw-plichtige optie van de crediteur.

Voor afwijkende BTW-bedragen kunnen de velden: BEDRBTWHOOG, BEDRBTWLAAG, BEDRBTWGEEN ,BEDRBTWBINEU, BEDRBTWBINEULAA, BEDRBTWBINEUGEE ,BEDRBTWBUIEU, BEDRBTWBUIEULAA, BEDRBTWBUIEUGEE en/of BEDRBTWVERLEGD.

VOORBEELD WAARDE INBOEKEN INKOOPFACTUURREGEL
Voorbeeld van de waarde in de request  tag <Inkoopfactuur></Inkoopfactuur>, bij het inboeken van een een factuurregel.

<NewDataSet>
<IFCBK>
<CRE>20000</CRE>
<DATFACT>01-08-2017</DATFACT>
<JRFACT>2017</JRFACT>
<PNFACT>8</PNFACT>
<BOEKSTUK>BST20170001</BOEKSTUK>
<KENMFACT>KNM20170001/KENMFACT>
<OMSCHR>Omschrijving van inkoopfactuur</OMSCHR>
<OPMFACT>Opmerking van inkoopfactuur</OPMFACT>
<BETWIST>N</BETWIST>
</IFCBK>
<INKRG>
<ORDNR>20170001</ORDNR>
<RG>5</RG>
<ART>9000</ART>
<OPFACTUUR>5</OPFACTUUR>
<PRSFACT>120</PRSFACT>
<PERCKORTFACT>5</PERCKORTFACT>
</INKRG>
</NewDataSet>

SOAP RESPONSE

<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <CreateInkoopfactuurResponse xmlns="https://cloudswitch.imuisonline.com/">
      <CreateInkoopfactuurResult>true</CreateInkoopfactuurResult>
      <Inkoopfactuur>zie voorbeeld</Inkoopfactuur>
      <INKFACTNR>20170001</INKFACTNR>
      <Foutmelding></Foutmelding>
    </CreateInkoopfactuurResponse>
  </soap12:Body>
</soap12:Envelope>

In dit voorbeeld is het inkoopfactuurnummer (INKFACTNR) van de 20170001 geworden. Dit nummer is uniek factuurnummer en wordt zowel in het factuurregister als aan de opboeking(en) van de journaalpost gekoppeld.  Als dit nummer gevuld is, dan is het boeken gelukt.

VOORBEELD RESPONSE NA INBOEKEN INKOOPFACTUUR
Response waarde voor tag <Inkoopfactuur></Inkoopfactuur>, na het inboeken van de inkoopfactuur.

<NewDataSet>
<IFCBK>
<CRE>20000</CRE>
<DATFACT>01-08-2017</DATFACT>
<JRFACT>2017</JRFACT>
<PNFACT>8</PNFACT>
<BOEKSTUK>BST20170001</BOEKSTUK>
<KENMFACT>KNM20170001/KENMFACT>
<OMSCHR>Omschrijving van inkoopfactuur</OMSCHR>
<OPMFACT>Opmerking van inkoopfactuur</OPMFACT>
<BETWIST>N</BETWIST>
</IFCBK>
<INKRG>
<ART>9000</ART>
<AANT>5</AANT>
<OPFACTUUR>5</OPFACTUUR>
<PRSFACT>120</PRSFACT>
<PERCKORTFACT>5</PERCKORTFACT>
<GEFACTUREERD>5</GEFACTUREERD>
<RG>5</RG>
<ORDNR>20170001</ORDNR>
</INKRG>
</NewDataSet>

Gerelateerde Artikelen