Self-Bill and Franchise en base de TVA

General Guidelines

Self-bill is posted,

keeping in mind general guidelines for Self-Bill and Franchise en base de TVA.

When VAT is 0, then ventilation code is set to "VentilationCode" is 1.

2 specific data elements need to be set

Data element	How to set the data element
VATDeductable : false	API in invoice payload
SmallEnterprise : false	API : update supplier information

VATDeductable

Invoice Payload : set VATDeductable : false

Below an example of the Supplier section of the API payload of the Self-Bill Invoice or CreditNote.

        "Supplier": {
            "Name": "EVstudio",
            "VATNumber": "",
            "PartyType": "Supplier",
            "VATDeductable": false,
            "Addresses": [
                {
                    "AddressType": "InvoiceAddress",
                    "Name": "Company Name",
                    "Street": "9 Rue Test",
                    "City": "Strasbourg",
                    "Zipcode": "67000",
                    "CountryCode": "FR"
                }
            ],
            "Identifiers": [
                {
                    "IdentifierType": "SIREN",
                    "Identifier": "791341999",
                    "Preferred": false
                },
                {
                    "IdentifierType": "CTC",
                    "Identifier": "791341999",
                    "Preferred": false
                }
            ]
        },

"SmallBusiness"

SmallBusiness must be set for the supplier. As it cannot be set via the payload of the Invoice, it needs to be set once for each company/supplier combination where self-bill and franchise en base de TVA are applicable (not others).

Actions to launch :

Command : POST https://api.sandbox.billit.be/v1/parties
Header : include PartyID of the company
Body : content of the supplier

Example of the Posting:

Extra info:

URL of the posting (based on v1/parties)
PartyID of the company
Result of the posting : 200 OK is success, ID of the created or updated Supplier is returned

Example of the content:

{
    //"PartyID": 738332,  Not required
    "Nr": "S14",  //Not required
    "Name": "Killian CHENAL",
    "Addresses": [
        {
            "AddressType": "InvoiceAddress",
            "Name": "Supplier Name",
            "Street": "2 Rue Du Hameau",
            "StreetNumber": "17",
            "Box": "12",
            "Zipcode": "63200",
            "City": "Cellule",
            "CountryCode": "FR"
        }    ],
    "Email": "[email protected]",
    "VATNumber": "",  //Scenario : no VAT number 
    "PartyType": "Supplier",  //is Supplier, Not customer
    "VATLiable": false,  //can be set via this API or just in API body of invoice
    "Language": "FR",
    "VentilationCode": "4",
    "Identifiers": [  //needed to identify to supplier
        {
            "IdentifierType": "Siren",
            "Identifier": "941810046",
            "SchemeID": "0002",
            "Preferred": false,
            "IdentifierAddress": ":941810046"
        },
         {
            "IdentifierType": "CTC",
            "Identifier": "941810046",
            "SchemeID": "0225",
            "Preferred": false,
            "IdentifierAddress": ":941810046"
        }
    ],
    "SmallEnterprise": true,  //the element that must be updated
}