| Requires any of the roles: | bookingsupplier-administrator-write, superadmin |
| PUT | /articles/mappings | Update external article mappings for the company articles | Create or update mappings between BokaMera articles and articles in an external system, for example e-accounting |
|---|
import java.math.*
import java.util.*
import java.io.InputStream
import net.servicestack.client.*
import com.google.gson.annotations.*
import com.google.gson.reflect.*
@ValidateRequest(Validator="IsAuthenticated")
open class UpdateArticleMappings : ICompany
{
/**
* Company to update article mappings for
*/
@ApiMember(Description="Company to update article mappings for")
override var CompanyId:UUID? = null
/**
* The article mappings to create or update
*/
@ApiMember(Description="The article mappings to create or update", IsRequired=true)
open var ArticleMappings:ArrayList<ArticleMappingToHandle> = ArrayList<ArticleMappingToHandle>()
}
open class ArticleMappingToHandle
{
/**
* The id of an existing mapping to update; leave empty to create a new one
*/
@ApiMember(Description="The id of an existing mapping to update; leave empty to create a new one")
open var Id:UUID? = null
/**
* The BokaMera article id
*/
@ApiMember(Description="The BokaMera article id")
open var ArticleId:Int? = null
/**
* The Reference Type: StripeArticle = 1, EAccountingArticle = 2
*/
@ApiMember(Description="The Reference Type: StripeArticle = 1, EAccountingArticle = 2")
open var ReferenceType:String? = null
/**
* The external reference; Values for EAccountingArticle, StripeArticle
*/
@ApiMember(Description="The external reference; Values for EAccountingArticle, StripeArticle")
open var ExternalReference:String? = null
}
Kotlin UpdateArticleMappings DTOs
To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml
The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.
PUT /articles/mappings HTTP/1.1
Host: api.bookmore.dev
Accept: application/xml
Content-Type: application/xml
Content-Length: length
<UpdateArticleMappings xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
<ArticleMappings>
<ArticleMappingToHandle>
<ArticleId>0</ArticleId>
<ExternalReference>String</ExternalReference>
<Id>00000000-0000-0000-0000-000000000000</Id>
<ReferenceType>String</ReferenceType>
</ArticleMappingToHandle>
</ArticleMappings>
<CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
</UpdateArticleMappings>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length
<ArrayOfArticleMappingResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/BokaMera.API.ServiceModel.Dtos">
<ArticleMappingResponse>
<ArticleId>0</ArticleId>
<CompanyId>00000000-0000-0000-0000-000000000000</CompanyId>
<ExternalReference>String</ExternalReference>
<Id>00000000-0000-0000-0000-000000000000</Id>
<ReferenceType>String</ReferenceType>
</ArticleMappingResponse>
</ArrayOfArticleMappingResponse>