| 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 datetime
import decimal
from marshmallow.fields import *
from servicestack import *
from typing import *
from dataclasses import dataclass, field
from dataclasses_json import dataclass_json, LetterCase, Undefined, config
from enum import Enum, IntEnum
Object = TypeVar('Object')
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class ArticleMappingToHandle:
# @ApiMember(Description="The id of an existing mapping to update; leave empty to create a new one")
id: Optional[str] = None
"""
The id of an existing mapping to update; leave empty to create a new one
"""
# @ApiMember(Description="The BokaMera article id")
article_id: int = 0
"""
The BokaMera article id
"""
# @ApiMember(Description="The Reference Type: StripeArticle = 1, EAccountingArticle = 2")
reference_type: Optional[str] = None
"""
The Reference Type: StripeArticle = 1, EAccountingArticle = 2
"""
# @ApiMember(Description="The external reference; Values for EAccountingArticle, StripeArticle")
external_reference: Optional[str] = None
"""
The external reference; Values for EAccountingArticle, StripeArticle
"""
# @ValidateRequest(Validator="IsAuthenticated")
@dataclass_json(letter_case=LetterCase.CAMEL, undefined=Undefined.EXCLUDE)
@dataclass
class UpdateArticleMappings(ICompany):
# @ApiMember(Description="Company to update article mappings for")
company_id: Optional[str] = None
"""
Company to update article mappings for
"""
# @ApiMember(Description="The article mappings to create or update", IsRequired=true)
article_mappings: List[ArticleMappingToHandle] = field(default_factory=list)
"""
The article mappings to create or update
"""
Python 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: testapi.bokamera.se
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>