| POST | /eaccounting/invoice |
|---|
"use strict";
export class InvoiceAddressResponse {
/** @param {{InvoiceAddressId?:string,UserId?:string,CorporateIdentityNumber?:string,InvoiceAddress1?:string,InvoiceAddress2?:string,InvoiceCity?:string,InvoicePostalCode?:string,InvoiceCountryCode?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
InvoiceAddressId;
/** @type {?string} */
UserId;
/** @type {string} */
CorporateIdentityNumber;
/** @type {string} */
InvoiceAddress1;
/** @type {string} */
InvoiceAddress2;
/** @type {string} */
InvoiceCity;
/** @type {string} */
InvoicePostalCode;
/** @type {string} */
InvoiceCountryCode;
}
/** @typedef {'None'|'SolarCellInstallation'|'ElectricEnergyStorageInstallation'|'ElectricVehicleChargingPointInstallation'} */
export var GreenTechnologyType;
(function (GreenTechnologyType) {
GreenTechnologyType["None"] = "None"
GreenTechnologyType["SolarCellInstallation"] = "SolarCellInstallation"
GreenTechnologyType["ElectricEnergyStorageInstallation"] = "ElectricEnergyStorageInstallation"
GreenTechnologyType["ElectricVehicleChargingPointInstallation"] = "ElectricVehicleChargingPointInstallation"
})(GreenTechnologyType || (GreenTechnologyType = {}));
export class ContributionMargin {
/** @param {{Amount?:number,Percentage?:number}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {?number} */
Amount;
/** @type {?number} */
Percentage;
}
export class InvoiceLineQueryResponse {
/** @param {{ArticleNumber?:string,ArticleId?:string,IsServiceArticle?:boolean,AmountNoVat?:number,PercentVat?:number,LineNumber?:number,IsTextRow?:boolean,Text?:string,UnitPrice?:number,UnitAbbreviation?:string,UnitAbbreviationEnglish?:string,DiscountPercentage?:number,Quantity?:number,IsWorkCost?:boolean,IsVatFree?:boolean,CostCenterItemId1?:string,CostCenterItemId2?:string,CostCenterItemId3?:string,UnitId?:string,ProjectId?:string,WorkCostType?:number,WorkHours?:number,MaterialCosts?:number,GreenTechnologyType?:GreenTechnologyType,ContributionMargin?:ContributionMargin}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
ArticleNumber;
/** @type {string} */
ArticleId;
/** @type {boolean} */
IsServiceArticle;
/** @type {number} */
AmountNoVat;
/** @type {?number} */
PercentVat;
/** @type {number} */
LineNumber;
/** @type {boolean} */
IsTextRow;
/** @type {string} */
Text;
/** @type {number} */
UnitPrice;
/** @type {string} */
UnitAbbreviation;
/** @type {string} */
UnitAbbreviationEnglish;
/** @type {number} */
DiscountPercentage;
/** @type {number} */
Quantity;
/** @type {boolean} */
IsWorkCost;
/** @type {boolean} */
IsVatFree;
/** @type {string} */
CostCenterItemId1;
/** @type {string} */
CostCenterItemId2;
/** @type {string} */
CostCenterItemId3;
/** @type {string} */
UnitId;
/** @type {string} */
ProjectId;
/** @type {?number} */
WorkCostType;
/** @type {?number} */
WorkHours;
/** @type {?number} */
MaterialCosts;
/** @type {?GreenTechnologyType} */
GreenTechnologyType;
/** @type {ContributionMargin} */
ContributionMargin;
}
export class VatSpecificationQueryResponse {
/** @param {{AmountInvoiceCurrency?:number,VatAmountInvoiceCurrency?:number,VatPercent?:number}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {number} */
AmountInvoiceCurrency;
/** @type {number} */
VatAmountInvoiceCurrency;
/** @type {number} */
VatPercent;
}
export class Person {
/** @param {{Ssn?:string,Amount?:number}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
Ssn;
/** @type {number} */
Amount;
}
export class EAccountingInvoiceAddress {
/** @param {{CorporateIdentityNumber?:string,InvoiceAddress1?:string,InvoiceAddress2?:string,InvoiceCity?:string,InvoicePostalCode?:string,InvoiceCountryCode?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
CorporateIdentityNumber;
/** @type {string} */
InvoiceAddress1;
/** @type {string} */
InvoiceAddress2;
/** @type {string} */
InvoiceCity;
/** @type {string} */
InvoicePostalCode;
/** @type {string} */
InvoiceCountryCode;
}
export class EAccountingTermsOfPaymentQueryResponse {
/** @param {{Id?:string,Name?:string,NameEnglish?:string,NumberOfDays?:number,TermsOfPaymentTypeId?:number,TermsOfPaymentTypeText?:string,AvailableForSales?:boolean,AvailableForPurchase?:boolean}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
Id;
/** @type {string} */
Name;
/** @type {string} */
NameEnglish;
/** @type {number} */
NumberOfDays;
/** @type {number} */
TermsOfPaymentTypeId;
/** @type {string} */
TermsOfPaymentTypeText;
/** @type {boolean} */
AvailableForSales;
/** @type {boolean} */
AvailableForPurchase;
}
export class NoteQueryResponse {
/** @param {{Id?:string,Text?:string,CreatedUtc?:string,ModifiedUtc?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
Id;
/** @type {string} */
Text;
/** @type {string} */
CreatedUtc;
/** @type {string} */
ModifiedUtc;
}
/** @typedef {'None'|'AutoInvoiceElectronic'|'AutoInvoicePrint'|'AutoInvoiceB2C'} */
export var EAccountingInvoiceSendTypes;
(function (EAccountingInvoiceSendTypes) {
EAccountingInvoiceSendTypes["None"] = "None"
EAccountingInvoiceSendTypes["AutoInvoiceElectronic"] = "AutoInvoiceElectronic"
EAccountingInvoiceSendTypes["AutoInvoicePrint"] = "AutoInvoicePrint"
EAccountingInvoiceSendTypes["AutoInvoiceB2C"] = "AutoInvoiceB2C"
})(EAccountingInvoiceSendTypes || (EAccountingInvoiceSendTypes = {}));
/** @typedef {'Paid'|'Unpaid'|'Overdue'} */
export var PaymentStatus;
(function (PaymentStatus) {
PaymentStatus["Paid"] = "Paid"
PaymentStatus["Unpaid"] = "Unpaid"
PaymentStatus["Overdue"] = "Overdue"
})(PaymentStatus || (PaymentStatus = {}));
export class CreditedBy {
/** @param {{CreditInvoiceId?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
CreditInvoiceId;
}
export class InvoiceQueryResponse {
/** @param {{InvoiceId?:string,CreatedDate?:string,TotalAmount?:number,TotalVatAmount?:number,CustomerId?:string,Rows?:InvoiceLineQueryResponse[],VatSpecification?:VatSpecificationQueryResponse[],InvoiceDate?:string,DueDate?:string,DeliveryDate?:string,Persons?:Person[],InvoiceCustomerName?:string,InvoiceAddress?:EAccountingInvoiceAddress,CustomerIsPrivatePerson?:boolean,TermsOfPaymentId?:string,TermsOfPaymentData?:EAccountingTermsOfPaymentQueryResponse,CustomerEmail?:string,InvoiceNumber?:number,CustomerNumber?:string,Notes?:NoteQueryResponse[],NoteIds?:string[],CreatedUtc?:string,ModifiedUtc?:string,IncludesVat?:boolean,SendType?:EAccountingInvoiceSendTypes,IsSold?:boolean,PaymentDate?:string,PaymentStatus?:PaymentStatus,PaymentStatusTitle?:string,CreditedBy?:CreditedBy[],PriceSign?:string,BookingId?:string}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {string} */
InvoiceId;
/** @type {string} */
CreatedDate;
/** @type {number} */
TotalAmount;
/** @type {number} */
TotalVatAmount;
/** @type {string} */
CustomerId;
/** @type {InvoiceLineQueryResponse[]} */
Rows = [];
/** @type {VatSpecificationQueryResponse[]} */
VatSpecification = [];
/** @type {string} */
InvoiceDate;
/** @type {string} */
DueDate;
/** @type {?string} */
DeliveryDate;
/** @type {Person[]} */
Persons = [];
/** @type {string} */
InvoiceCustomerName;
/** @type {EAccountingInvoiceAddress} */
InvoiceAddress;
/** @type {boolean} */
CustomerIsPrivatePerson;
/** @type {string} */
TermsOfPaymentId;
/** @type {EAccountingTermsOfPaymentQueryResponse} */
TermsOfPaymentData;
/** @type {string} */
CustomerEmail;
/** @type {number} */
InvoiceNumber;
/** @type {string} */
CustomerNumber;
/** @type {NoteQueryResponse[]} */
Notes = [];
/** @type {string[]} */
NoteIds = [];
/** @type {string} */
CreatedUtc;
/** @type {string} */
ModifiedUtc;
/** @type {boolean} */
IncludesVat;
/** @type {?EAccountingInvoiceSendTypes} */
SendType;
/** @type {boolean} */
IsSold;
/** @type {?string} */
PaymentDate;
/** @type {PaymentStatus} */
PaymentStatus;
/** @type {string} */
PaymentStatusTitle;
/** @type {CreditedBy[]} */
CreditedBy = [];
/** @type {string} */
PriceSign;
/** @type {string} */
BookingId;
}
export class CreateInvoiceQueryResponse {
/** @param {{Invoice?:InvoiceQueryResponse,InvoiceUri?:string,ResponseStatus?:ResponseStatus}} [init] */
constructor(init) { Object.assign(this, init) }
/** @type {InvoiceQueryResponse} */
Invoice;
/** @type {string} */
InvoiceUri;
/** @type {ResponseStatus} */
ResponseStatus;
}
/** @typedef {number} */
export var RotPropertyTypes;
(function (RotPropertyTypes) {
RotPropertyTypes[RotPropertyTypes["Apartment"] = 1] = "Apartment"
RotPropertyTypes[RotPropertyTypes["Property"] = 2] = "Property"
})(RotPropertyTypes || (RotPropertyTypes = {}));
/** @typedef {'Normal'|'Rot'|'Rut'} */
export var RotReducedInvoicingTypes;
(function (RotReducedInvoicingTypes) {
RotReducedInvoicingTypes["Normal"] = "Normal"
RotReducedInvoicingTypes["Rot"] = "Rot"
RotReducedInvoicingTypes["Rut"] = "Rut"
})(RotReducedInvoicingTypes || (RotReducedInvoicingTypes = {}));
export class CreateInvoice extends InvoiceAddressResponse {
/** @param {{BookingId?:number,TermsOfPaymentId?:string,Notes?:string[],InvoiceCustomerName?:string,SendType?:EAccountingInvoiceSendTypes,RotPropertyType?:RotPropertyTypes,RotReducedInvoicingType?:RotReducedInvoicingTypes,CompanyId?:string,InvoiceAddressId?:string,UserId?:string,CorporateIdentityNumber?:string,InvoiceAddress1?:string,InvoiceAddress2?:string,InvoiceCity?:string,InvoicePostalCode?:string,InvoiceCountryCode?:string}} [init] */
constructor(init) { super(init); Object.assign(this, init) }
/**
* @type {number}
* @description The booking id, to be used to create the customer. */
BookingId;
/**
* @type {string}
* @description The Term of payment Id, to be used to create the invoice. */
TermsOfPaymentId;
/**
* @type {string[]}
* @description Note id's to add to this invoice */
Notes = [];
/**
* @type {string}
* @description Invoice Customer name */
InvoiceCustomerName;
/**
* @type {EAccountingInvoiceSendTypes}
* @description Used for sending the invoice via Auto-invoice Default:None, 0 = None, 1 = AutoInvoiceElectronic, 2 = AutoInvoicePrint, 3 = AutoInvoiceB2C = ['0', '1', '2', '3']. */
SendType;
/**
* @type {RotPropertyTypes}
* @description 1 = Apartment, 2 = Property Leave blank or set to null if you do not intend to use ROT or Green Technology functionality. */
RotPropertyType;
/**
* @type {RotReducedInvoicingTypes}
* @description 0 = Normal, 1 = Rot, 2 = Rut = ['0', '1', '2'] */
RotReducedInvoicingType;
/**
* @type {?string}
* @description The company id, if empty will use the company id for the user you are logged in with. */
CompanyId;
}
To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
POST /eaccounting/invoice HTTP/1.1
Host: api.bokamera.se
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
BookingId: 0,
Notes:
[
String
],
InvoiceCustomerName: String,
SendType: None,
RotPropertyType: 0,
RotReducedInvoicingType: Normal,
CompanyId: 00000000-0000-0000-0000-000000000000,
UserId: 00000000-0000-0000-0000-000000000000,
CorporateIdentityNumber: String,
InvoiceAddress1: String,
InvoiceAddress2: String,
InvoiceCity: String,
InvoicePostalCode: String,
InvoiceCountryCode: String
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
Invoice:
{
TotalAmount: 0,
TotalVatAmount: 0,
CustomerId: String,
Rows:
[
{
ArticleNumber: String,
ArticleId: String,
IsServiceArticle: False,
AmountNoVat: 0,
PercentVat: 0,
LineNumber: 0,
IsTextRow: False,
Text: String,
UnitPrice: 0,
UnitAbbreviation: String,
UnitAbbreviationEnglish: String,
DiscountPercentage: 0,
Quantity: 0,
IsWorkCost: False,
IsVatFree: False,
CostCenterItemId1: String,
CostCenterItemId2: String,
CostCenterItemId3: String,
UnitId: String,
ProjectId: String,
WorkCostType: 0,
WorkHours: 0,
MaterialCosts: 0,
GreenTechnologyType: None,
ContributionMargin:
{
Amount: 0,
Percentage: 0
}
}
],
VatSpecification:
[
{
AmountInvoiceCurrency: 0,
VatAmountInvoiceCurrency: 0,
VatPercent: 0
}
],
InvoiceDate: String,
DueDate: String,
DeliveryDate: "0001-01-01T00:00:00",
Persons:
[
{
Ssn: String,
Amount: 0
}
],
InvoiceCustomerName: String,
InvoiceAddress:
{
CorporateIdentityNumber: String,
InvoiceAddress1: String,
InvoiceAddress2: String,
InvoiceCity: String,
InvoicePostalCode: String,
InvoiceCountryCode: String
},
CustomerIsPrivatePerson: False,
TermsOfPaymentId: String,
TermsOfPaymentData:
{
Id: String,
Name: String,
NameEnglish: String,
NumberOfDays: 0,
TermsOfPaymentTypeId: 0,
TermsOfPaymentTypeText: String,
AvailableForSales: False,
AvailableForPurchase: False
},
CustomerEmail: String,
InvoiceNumber: 0,
CustomerNumber: String,
Notes:
[
{
Id: String,
Text: String
}
],
NoteIds:
[
String
],
IncludesVat: False,
SendType: None,
IsSold: False,
PaymentDate: "0001-01-01T00:00:00",
PaymentStatus: Paid,
PaymentStatusTitle: String,
CreditedBy:
[
{
CreditInvoiceId: String
}
],
PriceSign: String,
BookingId: String
},
InvoiceUri: String,
ResponseStatus:
{
ErrorCode: String,
Message: String,
StackTrace: String,
Errors:
[
{
ErrorCode: String,
FieldName: String,
Message: String,
Meta:
{
String: String
}
}
],
Meta:
{
String: String
}
}
}