HostFact API versie 3.1



Inkoopfacturen

Inkoopfacturen (van crediteuren) zijn te beheren via de controller 'creditinvoice'.



add

Middels deze functie is het mogelijk een inkoopfactuur toe te voegen..
Voorbeeldbestand: /voorbeelden/creditinvoice/creditinvoice.add.php


Invoerparameters:
Veldnaam Waarde Omschrijving
CreditInvoiceCode string Eigen interne inkoopfactuurnummer
Geef deze parameter niet mee wanneer het inkoopfactuurnummer automatisch bepaald mag worden.
InvoiceCode string Factuurnummer (door crediteur)
ReferenceNumber string Referentie
Creditor int De unieke ID van een crediteur
CreditorCode string Het crediteurnummer
Date datetime Datum van de inkoopfactuur. Standaard: vandaag
Term int Betaaltermijn in dagen
AmountPaid float Bedrag reeds betaald
Authorisation 'yes' of 'no' Automatische incasso, standaard: voorkeur crediteur
PayDate date Datum dat inkoopfactuur betaald is
Private float Privé: bedrag
PrivatePercentage int Privé: percentage 0 - 100
Status int Factuur status, zie variabelen-lijst.
Standaard: 1 (nog niet betaald)
InvoiceLines array Inkoopfactuurregel:
- Number float     Aantal. Standaard: 1
- Description string     Omschrijving
- PriceExcl float     Prijs per stuk (excl. BTW)
- TaxPercentage float     BTW percentage: 0 - 100
Verplichte velden: Creditor of CreditorCode en InvoiceLines (minimaal 1)


Voorbeeld invoer:
<?php

require_once("../hostfact_api.php");

$api = new HostFactAPI();

$creditInvoiceParams = array(
				'CreditorCode'	=> 'CD0001',
				'InvoiceCode'	=> '2013-6422',
				'Date' 			=> '2013-12-04',
				
				'InvoiceLines' => array(
					array(
						'Description'	=> 'SLA contract #2',
						'PriceExcl'		=> 125
					),
					array(
						'Number'		=> 3,
						'Description'	=> 'Domains .com',
						'PriceExcl'		=> 12.50
					),
				)
);

$response = $api->sendRequest('creditinvoice', 'add', $creditInvoiceParams);

print_r_pre($response);

?>

Voorbeeld uitvoer:
Array
(
    [controller] => creditinvoice
    [action] => add
    [status] => success
    [date] => 2022-11-24T12:00:00+02:00
    [creditinvoice] => Array
        (
            [Identifier] => 2
            [CreditInvoiceCode] => CF0002
            [InvoiceCode] => 2013-6422
            [Creditor] => 1
            [CreditorCode] => CD0001
            [Status] => 1
            [Date] => 2013-12-04
            [Term] => 0
            [AmountExcl] => 162.50
            [AmountIncl] => 196.63
            [AmountPaid] => 0.00
            [Authorisation] => no
            [Private] => 0.00
            [PrivatePercentage] => 0
            [ReferenceNumber] => 
            [PayDate] => 
            [InvoiceLines] => Array
                (
                    [0] => Array
                        (
                            [Identifier] => 3
                            [Number] => 1
                            [Description] => SLA contract #2
                            [PriceExcl] => 125
                            [TaxPercentage] => 21
                        )

                    [1] => Array
                        (
                            [Identifier] => 4
                            [Number] => 3
                            [Description] => Domains .com
                            [PriceExcl] => 12.5
                            [TaxPercentage] => 21
                        )

                )

            [Created] => 2022-11-24 11:00:00
            [Modified] => 2022-11-24 11:00:00
            [Translations] => Array
                (
                    [Status] => Nog niet betaald
                )

        )

)