Customer is Private Person

Customer Info in MyBillit Interface

Result in detail screen of Customer in the MyBillit portal (advanced details screen has been selected)

Additional Info:

PartyID of the Customer (Technical ID)
Private person is not marked automatically in user interface of MyBillit customer screen (limitation, but not causing practical problems)
VAT number, company number is empty. Person is marked as not subject to VAT
Customer number communicated via API
Email address of the private person

What to include in Invoice Data when Customer is private

How to make sure that customer is created only once:

When posting the invoice, make sure that enough customer data are included in the correct way (see sample below)
- Email Address (the best way to distinguish, but then email address must be unique)
- Name (not an element of distinction, but to show the name)
- Phone
- Customer number (optional)
- IBAN,BIC (optional : is a good element of distinction, but not always available)
- flag VATLiable (not mandatory, goal is to make it clearer in customer overview)
Alternative Solution : Create customer before:
- Create
  - via Excel upload,
  - or via API,
- Get the PartyID of the customer (via API, or read on the screen)
- Post invoice including Party ID of the invoice

Examples (without and with PartyID)

{
 "OrderType": "Invoice",
 "OrderDirection": "Income",
 "OrderNumber": "QS-X016Private2",  
 "OrderDate": "2025-12-08",
 "ExpiryDate": "2025-12-30",
  "Customer": {
    "PartyType": "Customer", //Receiver of the Sales Invoice
    "Nr": "449", //This is the functional customer number (not the technical ID of the Party)
    "Name": "Jean Deboeuf2",
    "IBAN" : "BE1352308128999",  //Valid IBAN 
    "BIC" : "TRIOBEBB",  //Valid BIC 
    "VATLiable": false,  //flag on user interface will be set to false
    "Language": "E",       
    "Phone" : "+3224600999",
    "CountryCode" : "BE",
    "Email" : "[email protected]",//unique email is recommended
   "Addresses": [
      {
                "AddressType": "InvoiceAddress",
                "Name": "Jean Deboeuf8",
                "Street": "Teststraat",
                "StreetNumber": "99a",
                "Box": "301",
                "Zipcode": "9001",
                "City": "Gent",
                "CountryCode": "BE",
                "Phone": "+3224600369"
            },
            {
                "AddressType": "DeliveryAddress",
                "Name": "Jean Deboeuf8",
                "Street": "Teststraat",
                "StreetNumber": "99b",
                "Box": "302",
                "Zipcode": "9001",
                "City": "Gent",
                "CountryCode": "BE",
                "Phone": "+3224600369"
            }
        ],
   },
 "OrderLines": [ 
  {
   "Quantity": 1.02, 
   "UnitPriceExcl": 10.03, 
   "Reference": "915025", 
   "Description": "Box of cookies",  
   "VATPercentage": 6.0
   }
 ]
}

{
 "OrderType": "Invoice",
 "OrderDirection": "Income",
 "OrderNumber": "QS-X016Private1",  
 "OrderDate": "2025-12-08",
 "ExpiryDate": "2025-12-30",
  "Customer": {
    "PartyType": "Customer", //Receiver of the Sales Invoice
		"PartyID": 879263,  //This is the ID of the customer, so will be linked to this unique customer
    "Nr": "449", //This is the functional customer number (not the technical ID of the Party)
    "Name": "Jean Deboeuf2",
    "IBAN" : "BE1352308128999",  
    "BIC" : "TRIOBEBB",  
    "VATLiable": false,  //flag on user interface will be set to false
    "VATDeductable" : true, //flag on user interface will be set to false
    "Language": "NL", 
    "Street" : "Teststraat ",
    "Streetnumber" : "56",
    "box":"301", // Not mandatory
    "Zipcode" : "9001",          
    "Phone" : "+3224600364",
    "City" : "Gent",
    "CountryCode" : "BE",
    "Email" : "[email protected]"
   },
 "OrderLines": [ 
  {
   "Quantity": 1.02, 
   "UnitPriceExcl": 10.03, 
   "Reference": "915025", 
   "Description": "Box of cookies",  
   "VATPercentage": 6.0
   },
    {
   "Quantity": 2,
   "UnitPriceExcl": 3.75,
   "Description": "Sticks",
   "VATPercentage": 21.0
   }
 ]
}