Basecone Developers

Create a Vat Period or a list of Vat Periods for your company. Before making a POST request to create a vat period in your company, you might find it useful to look at the list of available companies.

POST accountingsystems/wkbelgium/vatperiods

Request details

The post request will contain all the required information to create a list of Vat Periods in your company. The list can be comprised by one or more Vat Periods

Request properties

Property	Type	Description	Optional
Request	Vat Periods request object	The Vat Periods request to add.	No

For Vat Periods create request object properties see details.

Example request

{
    "vatPeriodsRequest":
    [ 
        { 
            "externalId": "externalId",
            "company":{  
                "companyId": "companyId"
            },
            "nameDe": "NameDe",
            "nameEn": "NameEn",
            "nameFr": "NameFr",
            "nameNl": "NameNl",
            "startDate": "startDate",
            "endDate": "endDate"
        },
        { 
            "externalId": "externalId",
            "company":{  
                "companyId": "companyId"
            },
            "nameDe": "NameDe",
            "nameEn": "NameEn",
            "nameFr": "NameFr",
            "nameNl": "NameNl",
            "startDate": "startDate",
            "endDate": "endDate"
        }
    ]
}

Response

Upon successful creation of the Vat Periods in the Basecone system, a 201 http status code will be returned together with the newly created VatPeriodIds unique identifiers. If something goes wrong, an error message with failure details will be given together with a suitable http error status code.

Example response

{
  "VATPeriodId": "41b3360a-7ba3-3z02-890e-75z29a61edee"
}

Possible error responses

Status code	Error code	Details
400	invalid_request_payload	Requested payload is incorrect or empty
403	Forbidden	User does not have access to this company
404	Not Found	There are none Vat Period(s) to be created.