Abonnementen

Abonnementen zijn te beheren via de controller 'subscription'.

add

Middels deze functie is het mogelijk een overige dienst (abonnement) toe te voegen.

Invoerparameters:

Veldnaam	Waarde	Omschrijving
Debtor	int	De unieke ID van een debiteur
DebtorCode	string	Het debiteurnummer
Subscription	array	Abonnementsregel:
- Number	float	Aantal. Standaard: 1
- NumberSuffix	string	Eenheid bijvoorbeeld: Kg.
- ProductCode	string	Het productnummer
- Description	string	Omschrijving
- PriceExcl	float	Prijs per stuk (excl. BTW]
- TaxCode	string	BTW code Terug te vinden bij de BTW instellingen.
- DiscountPercentage	float	Korting abonnement, percentage: 0 - 100
- Periods	int	Factureer iedere: aantal periodes
- Periodic	string	Factureer iedere: eenheid, zie variabelen-lijst
- StartDate	date	Startdatum van de periode
- NextDate	date	Volgende facturatiedatum. Enkel beschikbaar indien de instelling 'vooraf factureren' op 0 staat ingesteld.
- TerminationDate	date	De datum waarop het abonnement opgezegd is
- TerminateAfter	int	Aantal keer dat het abonnement gefactureerd moet worden. 0 = onbepaalde duur.
- Comment	text	Interne notitie
- AccountingCostCentre	string	Code kostenplaats boekhoudpakket Enkel beschikbaar indien geactiveerd.
- AccountingProject	string	Code project boekhoudpakket Enkel beschikbaar indien geactiveerd.
- DirectDebit	'client', 'yes', 'no'	Betalen via automatisch incasso, standaard: 'client', gebruik de instelling van de debiteur.

Verplichte velden: Debtor of DebtorCode en ProductCode. Bij geen ProductCode zijn Description, PriceExcl en Periodic verplicht.

Let op: U kunt of de TerminateAfter of de TerminationDate meegeven, niet allebei. De TerminateAfter is inclusief het aantal keer dat het abonnement in het verleden gefactureerd is.

Voorbeeld invoer:

$parameters = [
    "DebtorCode" => "DB10000",
    "Subscription" => [
        "ProductCode" => "P0001"
    ]
];

$api->sendRequest('subscription', 'add', $parameters);

Voorbeeld uitvoer:

Array
(
    [controller] => subscription
    [action] => add
    [status] => success
    [date] => 2024-01-21T12:00:00+02:00
    [success] => Array
        (
            [0] => Abonnement Service contract is aangemaakt.
            [1] => Abonnement Service contract van debiteur DB10000 is gefactureerd.
        )

    [subscription] => Array
        (
            [Identifier] => 1
            [Debtor] => 1
            [DebtorCode] => DB10000
            [Number] => 1
            [NumberSuffix] => 
            [ProductCode] => P0001
            [Description] => Service contract
            [PriceExcl] => 150
            [PriceIncl] => 181.5
            [Currency] => EUR
            [TaxCode] => V21
            [TaxPercentage] => 21
            [DiscountPercentage] => 0
            [Periods] => 1
            [Periodic] => m
            [StartDate] => 2024-10-25
            [EndDate] => 2024-11-24
            [StartPeriod] => 2024-10-25
            [EndPeriod] => 2024-11-25
            [NextDate] => 2024-10-25
            [Comment] => 
            [TerminateAfter] => 0
            [TerminationDate] => 
            [AmountExcl] => 150
            [AmountIncl] => 181.5
            [DirectDebit] => client
            [DiscountAmountExcl] => 0
            [DiscountAmountIncl] => 0
            [Created] => 2024-01-21 11:00:00
            [Modified] => 2024-01-21 11:00:00
        )

)

Hoofdstukken

Abonnementen

add

Invoerparameters:

Voorbeeld invoer:

Voorbeeld uitvoer:

Klaar om 30 dagen gratis te proberen?

Maak gebruik van de gratis opstartservice

Maak een proefperiode aan

Klaar om 30 dagen
gratis te proberen?