| Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
| POST | /billing/company/ | Add new billing information. | Add new billing information. |
|---|
import Foundation
import ServiceStack
// @ApiResponse(Description="You were unauthorized to call this service", StatusCode=401)
// @ValidateRequest(Validator="IsAuthenticated")
public class AddBillingInformation : BillingInfoBase, ICompany
{
/**
* The company id, if empty will use the company id for the user you are logged in with.
*/
// @ApiMember(Description="The company id, if empty will use the company id for the user you are logged in with.")
public var companyId:String?
/**
* The name that should be printed on the billing information, normally this would be your company name.
*/
// @ApiMember(Description="The name that should be printed on the billing information, normally this would be your company name.")
public var name:String
/**
* If you want to add the attention to the billing person.
*/
// @ApiMember(Description="If you want to add the attention to the billing person.")
public var attention:String
/**
* The street for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The street for the billing adress. This is required when having postal invoice as billing method.")
public var street1:String
/**
* The street for the billing adress.
*/
// @ApiMember(Description="The street for the billing adress.")
public var street2:String
/**
* The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.")
public var zipCode:String
/**
* The city for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The city for the billing adress. This is required when having postal invoice as billing method.")
public var city:String
/**
* The billing email. This is required when having email invoice as billing method.
*/
// @ApiMember(Description="The billing email. This is required when having email invoice as billing method.")
public var email:String
/**
* The billing payment terms in days. This is default 15 days.
*/
// @ApiMember(Description="The billing payment terms in days. This is default 15 days.")
public var paymentTermsDays:Int?
/**
* The company vat registration number.
*/
// @ApiMember(Description="The company vat registration number.")
public var vatRegistrationNumber:String
/**
* The company global location number.
*/
// @ApiMember(Description="The company global location number.")
public var gln:String
/**
* Your internal reference.
*/
// @ApiMember(Description="Your internal reference.")
public var referenceLine1:String
/**
* Your internal reference.
*/
// @ApiMember(Description="Your internal reference.")
public var referenceLine2:String
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case companyId
case name
case attention
case street1
case street2
case zipCode
case city
case email
case paymentTermsDays
case vatRegistrationNumber
case gln
case referenceLine1
case referenceLine2
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
companyId = try container.decodeIfPresent(String.self, forKey: .companyId)
name = try container.decodeIfPresent(String.self, forKey: .name)
attention = try container.decodeIfPresent(String.self, forKey: .attention)
street1 = try container.decodeIfPresent(String.self, forKey: .street1)
street2 = try container.decodeIfPresent(String.self, forKey: .street2)
zipCode = try container.decodeIfPresent(String.self, forKey: .zipCode)
city = try container.decodeIfPresent(String.self, forKey: .city)
email = try container.decodeIfPresent(String.self, forKey: .email)
paymentTermsDays = try container.decodeIfPresent(Int.self, forKey: .paymentTermsDays)
vatRegistrationNumber = try container.decodeIfPresent(String.self, forKey: .vatRegistrationNumber)
gln = try container.decodeIfPresent(String.self, forKey: .gln)
referenceLine1 = try container.decodeIfPresent(String.self, forKey: .referenceLine1)
referenceLine2 = try container.decodeIfPresent(String.self, forKey: .referenceLine2)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if companyId != nil { try container.encode(companyId, forKey: .companyId) }
if name != nil { try container.encode(name, forKey: .name) }
if attention != nil { try container.encode(attention, forKey: .attention) }
if street1 != nil { try container.encode(street1, forKey: .street1) }
if street2 != nil { try container.encode(street2, forKey: .street2) }
if zipCode != nil { try container.encode(zipCode, forKey: .zipCode) }
if city != nil { try container.encode(city, forKey: .city) }
if email != nil { try container.encode(email, forKey: .email) }
if paymentTermsDays != nil { try container.encode(paymentTermsDays, forKey: .paymentTermsDays) }
if vatRegistrationNumber != nil { try container.encode(vatRegistrationNumber, forKey: .vatRegistrationNumber) }
if gln != nil { try container.encode(gln, forKey: .gln) }
if referenceLine1 != nil { try container.encode(referenceLine1, forKey: .referenceLine1) }
if referenceLine2 != nil { try container.encode(referenceLine2, forKey: .referenceLine2) }
}
}
public class BillingInfoBase : IBillingInfo, Codable
{
public var firstName:String
public var lastName:String
public var phoneNumber:String
public var countryId:String
public var billingMethodId:Int
required public init(){}
}
public class BillingInformationResponse : Codable
{
/**
* The company id.
*/
// @ApiMember(Description="The company id.")
public var companyId:String
/**
* The prefered billing method.
*/
// @ApiMember(Description="The prefered billing method.", IsRequired=true)
public var billingMethodId:Int
/**
* The name that should be printed on the billing information, normally this would be your company name.
*/
// @ApiMember(Description="The name that should be printed on the billing information, normally this would be your company name.")
public var name:String
/**
* Billing person first name
*/
// @ApiMember(Description="Billing person first name")
public var firstName:String
/**
* Billing person last name
*/
// @ApiMember(Description="Billing person last name")
public var lastName:String
/**
* Billing person phone numbers
*/
// @ApiMember(Description="Billing person phone numbers")
public var phoneNumber:String
/**
* If you want to add the attention to the billing address.
*/
// @ApiMember(Description="If you want to add the attention to the billing address.")
public var attention:String
/**
* The street for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The street for the billing adress. This is required when having postal invoice as billing method.")
public var street1:String
/**
* The street for the billing adress.
*/
// @ApiMember(Description="The street for the billing adress.")
public var street2:String
/**
* The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The zip code (postal code) for the billing adress. This is required when having postal invoice as billing method.")
public var zipCode:String
/**
* The city for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The city for the billing adress. This is required when having postal invoice as billing method.")
public var city:String
/**
* The country for the billing adress. This is required when having postal invoice as billing method.
*/
// @ApiMember(Description="The country for the billing adress. This is required when having postal invoice as billing method.")
public var countryId:String
/**
* The billing email. This is required when having email invoice as billing method.
*/
// @ApiMember(Description="The billing email. This is required when having email invoice as billing method.")
public var email:String
/**
* The company global location number.
*/
// @ApiMember(Description="The company global location number.")
public var gln:String
/**
* Your internal reference.
*/
// @ApiMember(Description="Your internal reference.")
public var referenceLine1:String
/**
* Your internal reference.
*/
// @ApiMember(Description="Your internal reference.")
public var referenceLine2:String
/**
* The billing payment terms in days. This is default 15 days.
*/
// @ApiMember(Description="The billing payment terms in days. This is default 15 days.")
public var paymentTermsDays:Int
/**
* The company vat registration number.
*/
// @ApiMember(Description="The company vat registration number.")
public var vatRegistrationNumber:String
/**
* The billing method options to choose from
*/
// @ApiMember(Description="The billing method options to choose from")
public var billingMethodOptions:[BillingMethod] = []
required public init(){}
}
public class BillingMethod : BaseModel
{
public var billingMethodCountriesRelation:[BillingMethodCountriesRelation] = []
// @Required()
public var name:String?
// @Required()
public var Description:String?
public var modifiedDate:Date?
public var id:Int
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case billingMethodCountriesRelation
case name
case Description
case modifiedDate
case id
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
billingMethodCountriesRelation = try container.decodeIfPresent([BillingMethodCountriesRelation].self, forKey: .billingMethodCountriesRelation) ?? []
name = try container.decodeIfPresent(String.self, forKey: .name)
Description = try container.decodeIfPresent(String.self, forKey: .Description)
modifiedDate = try container.decodeIfPresent(Date.self, forKey: .modifiedDate)
id = try container.decodeIfPresent(Int.self, forKey: .id)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if billingMethodCountriesRelation.count > 0 { try container.encode(billingMethodCountriesRelation, forKey: .billingMethodCountriesRelation) }
if name != nil { try container.encode(name, forKey: .name) }
if Description != nil { try container.encode(Description, forKey: .Description) }
if modifiedDate != nil { try container.encode(modifiedDate, forKey: .modifiedDate) }
if id != nil { try container.encode(id, forKey: .id) }
}
}
public class BaseModel : Codable
{
required public init(){}
}
public class BillingMethodCountriesRelation : BaseModel
{
// @Required()
public var billingMethodId:Int?
// @Required()
public var countryId:String?
public var modifiedDate:Date?
required public init(){ super.init() }
private enum CodingKeys : String, CodingKey {
case billingMethodId
case countryId
case modifiedDate
}
required public init(from decoder: Decoder) throws {
try super.init(from: decoder)
let container = try decoder.container(keyedBy: CodingKeys.self)
billingMethodId = try container.decodeIfPresent(Int.self, forKey: .billingMethodId)
countryId = try container.decodeIfPresent(String.self, forKey: .countryId)
modifiedDate = try container.decodeIfPresent(Date.self, forKey: .modifiedDate)
}
public override func encode(to encoder: Encoder) throws {
try super.encode(to: encoder)
var container = encoder.container(keyedBy: CodingKeys.self)
if billingMethodId != nil { try container.encode(billingMethodId, forKey: .billingMethodId) }
if countryId != nil { try container.encode(countryId, forKey: .countryId) }
if modifiedDate != nil { try container.encode(modifiedDate, forKey: .modifiedDate) }
}
}
Swift AddBillingInformation DTOs
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 /billing/company/ HTTP/1.1
Host: api.bokamera.se
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length
{
CompanyId: 00000000-0000-0000-0000-000000000000,
Name: String,
Attention: String,
Street1: String,
Street2: String,
ZipCode: String,
City: String,
Email: String,
PaymentTermsDays: 0,
VatRegistrationNumber: String,
GLN: String,
ReferenceLine1: String,
ReferenceLine2: String,
FirstName: String,
LastName: String,
PhoneNumber: String,
CountryId: String,
BillingMethodId: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length
{
BillingMethodId: 0,
Name: String,
FirstName: String,
LastName: String,
PhoneNumber: String,
Attention: String,
Street1: String,
Street2: String,
ZipCode: String,
City: String,
CountryId: String,
Email: String,
GLN: String,
ReferenceLine1: String,
ReferenceLine2: String,
PaymentTermsDays: 0,
VatRegistrationNumber: String,
BillingMethodOptions:
[
{
BillingMethodCountriesRelation:
[
{
BillingMethodId: 0,
CountryId: String,
ModifiedDate: 0001-01-01T00:00:00.0000000+00:00
}
],
Name: String,
Description: String,
ModifiedDate: 0001-01-01T00:00:00.0000000+00:00,
Id: 0
}
]
}