Taxes | SAF-T Import
The SAFT Imports end point is used to record information from saft files, such as items, documents and customers.
Overview
URL | api/{tenantKey}/{orgKey}/taxAuthorityPT/sAFTImports |
Methods Supported | GET, POST, PUT, DELETE |
All Operations
This service includes the following operations:
-
GET:
- GET SAFTImports
- GET SAFTImports (paged)
- GET SAFTImport by identifier
- GET SAFTImport by key
- GET Print SAFTImport by identifier
- GET Print SAFTImport by key
- GET Original Print SAFTImportOriginal by identifier
- GET Original Print SAFTImport by key
- GET Get SAFT Import Id By Request Id
- GET Get Parties Without Customers Extensions
- POST:
-
PUT:
- PUT Set IsActive SAFTImport
- PUT Set TaxRegistrationNumber SAFTImport
- PUT Set Filename SAFTImport
- PUT Set FirstDocumentDate SAFTImport
- PUT Set LastDocumentDate SAFTImport
- PUT Set TotalDocuments SAFTImport
- PUT Set TotalCustomers SAFTImport
- PUT Set TotalItems SAFTImport
- PUT Set TotalDocumentsImported SAFTImport
- PUT Set TotalCustomersImported SAFTImport
- PUT Set TotalItemsImported SAFTImport
- PUT Set StartDate SAFTImport
- PUT Set EndDate SAFTImport
- PUT Set SAFTImportStatus SAFTImport
- PUT Set SAFTImportRequest SAFTImport
- PUT Set Company SAFTImport
- PUT Set IsVerifyingCustomers SAFTImport
- PUT Set CustomersVerified SAFTImport
- PUT Set IsVerifyingItems SAFTImport
- PUT Set ItemsVerified SAFTImport
- PUT Set IsVerifyingDocuments SAFTImport
- PUT Set DocumentsVerified SAFTImport
- PUT Set ProductCode SAFTImportItem
- PUT Set ProductType SAFTImportItem
- PUT Set ProductDescription SAFTImportItem
- PUT Set ProductGroup SAFTImportItem
- PUT Set ProductNumberCode SAFTImportItem
- PUT Set ItemKey SAFTImportItem
- PUT Set Description SAFTImportItem
- PUT Set ItemType SAFTImportItem
- PUT Set ItemAccountType SAFTImportItem
- PUT Set Unit SAFTImportItem
- PUT Set ItemTaxSchema SAFTImportItem
- PUT Set ItemWithholdingTaxSchema SAFTImportItem
- PUT Set DimensionSetJson SAFTImportItem
- PUT Set PartyKey SAFTImportCustomer
- PUT Set Name SAFTImportCustomer
- PUT Set CustomerID SAFTImportCustomer
- PUT Set AccountID SAFTImportCustomer
- PUT Set CustomerTaxID SAFTImportCustomer
- PUT Set CompanyName SAFTImportCustomer
- PUT Set Telephone SAFTImportCustomer
- PUT Set Email SAFTImportCustomer
- PUT Set Website SAFTImportCustomer
- PUT Set CustomerGroup SAFTImportCustomer
- PUT Set PartyAccountType SAFTImportCustomer
- PUT Set OtherReceivable SAFTImportCustomer
- PUT Set AddressBuildingNumber SAFTImportCustomer
- PUT Set AddressStreetName SAFTImportCustomer
- PUT Set AddressDetail SAFTImportCustomer
- PUT Set AddressCity SAFTImportCustomer
- PUT Set AddressPostalCode SAFTImportCustomer
- PUT Set AddressRegion SAFTImportCustomer
- PUT Set AddressCountry SAFTImportCustomer
- PUT Set Fax SAFTImportCustomer
- PUT Set Cae SAFTImportCustomer
- PUT Set SelfBillingIndicator SAFTImportCustomer
- PUT Set ExistingNif SAFTImportCustomer
- PUT Set DimensionSetJson SAFTImportCustomer
- DELETE:
All Resources
This service uses the following resources:
- ApiSAFTImportResource
- ApiSAFTImportSAFTImportCustomersResource
- ApiSAFTImportSAFTImportItemsResource
- PartiesWithoutCustomersExtensions
- SAFTImportCustomerResource
- SAFTImportItemResource
- SAFTImportResource
- StandardSAFTImportResource
- StandardSAFTImportSAFTImportCustomersResource
- StandardSAFTImportSAFTImportItemsResource
All Enumerations
This service uses the following enumerations:
GET SAFTImports
Returns the list of all the entity records available.
Response:
When successful, the response body contains the list of records available. See SAFTImportResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET SAFTImports (paged)
Returns a page of the list of all the entity records available.
The following elements are optional:
page | (int) The index of the page of the list that should be returned. This is a query string parameter. |
pageSize | (int) The number of page elements that should be returned (max. is 1000). This is a query string parameter. |
Response:
When successful, the response body contains the list of records available. See SAFTImportResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET SAFTImport by identifier
Returns the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body contains the entity record. See SAFTImportResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET SAFTImport by key
Returns the entity record that matches the specified key.
The following elements are required:
companyKey | (string) The company key. |
sAFTImportKey | (int) Number. |
Response:
When successful, the response body contains the entity record. See SAFTImportResource. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET Print SAFTImport by identifier
Prints the specified entity record.
The following elements are required:
id | (string) The record identifier. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
404 | NotFound. The specified resord does not exist. |
Resource URL:
GET Print SAFTImport by key
Prints the specified entity record.
The following elements are required:
companyKey | (string) The company key. |
sAFTImportKey | (int) Number. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET Original Print SAFTImportOriginal by identifier
Prints the specified entity record.
The following elements are required:
id | (string) The record identifier. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
404 | NotFound. The specified resord does not exist. |
Resource URL:
GET Original Print SAFTImport by key
Prints the specified entity record.
The following elements are required:
companyKey | (string) The company key. |
sAFTImportKey | (int) Number. |
The following elements are optional:
template | (string) The report template that should be used. This is a query string parameter. |
Response:
When successful, the response body contains a stream with the printed file. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
GET Get SAFT Import Id By Request Id
This operation gets the saft import identifier from a request identifier.
The following elements are required:
requestId | (Guid) The Saft Request identifier. |
Response:
When successful, the response body contains a unique identifier. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
GET Get Parties Without Customers Extensions
This endpoint will get all parties without the customer extensions used on the process of the saft import.
The following elements are required:
saftImportId | (Guid) The saft import identifier. |
Response:
When successful, the response body contains a list of resources of type 'PartiesWithoutCustomersExtensions'. See PartiesWithoutCustomersExtensions. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
POST SAFTImports
Creates a new entity record.
The following elements are required:
sAFTImportResource | (ApiSAFTImportResource) The request body should contain the entity record that should be created. See ApiSAFTImportResource. |
Response:
When successful, the response body contains the new entity record identifier. The resource header location property contains the URL for the new entity record. See ApiSAFTImportResource. |
Response status codes:
201 | Created. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
POST SAF-T Import
Inserts a new 'SAFT Import Item' in the 'SAF-T Import'.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (ApiSAFTImportSAFTImportItemsResource) The ApiSAFTImportSAFTImportItemsResource instance. See ApiSAFTImportSAFTImportItemsResource. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
POST SAF-T Import
Inserts a new 'SAFT Import Customer' in the 'SAF-T Import'.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (ApiSAFTImportSAFTImportCustomersResource) The ApiSAFTImportSAFTImportCustomersResource instance. See ApiSAFTImportSAFTImportCustomersResource. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
POST Import Customers
Custom operation 'ImportCustomers'.
The following elements are required:
customer | (SAFTCustomer) Customer. |
Response:
When successful, the response body is empty. |
Resource URL:
POST Import Item
Custom operation 'ImportItem'.
The following elements are required:
item | (SAFTProduct) Item. |
Response:
When successful, the response body is empty. |
Resource URL:
POST Import Document
Custom operation 'ImportDocument'.
The following elements are required:
document | (SAFTDocument) Document. |
Response:
When successful, the response body is empty. |
Resource URL:
PUT Set AccountID SAFTImportCustomer
Updates the value of attribute 'AccountID' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressBuildingNumber SAFTImportCustomer
Updates the value of attribute 'AddressBuildingNumber' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressCity SAFTImportCustomer
Updates the value of attribute 'AddressCity' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressCountry SAFTImportCustomer
Updates the value of attribute 'AddressCountry' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressDetail SAFTImportCustomer
Updates the value of attribute 'AddressDetail' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressPostalCode SAFTImportCustomer
Updates the value of attribute 'AddressPostalCode' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressRegion SAFTImportCustomer
Updates the value of attribute 'AddressRegion' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set AddressStreetName SAFTImportCustomer
Updates the value of attribute 'AddressStreetName' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Cae SAFTImportCustomer
Updates the value of attribute 'Cae' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Company SAFTImport
Updates the value of attribute 'Company' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CompanyName SAFTImportCustomer
Updates the value of attribute 'CompanyName' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomerGroup SAFTImportCustomer
Updates the value of attribute 'CustomerGroup' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomerID SAFTImportCustomer
Updates the value of attribute 'CustomerID' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomersVerified SAFTImport
Updates the value of attribute 'CustomersVerified' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set CustomerTaxID SAFTImportCustomer
Updates the value of attribute 'CustomerTaxID' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Description SAFTImportItem
Updates the value of attribute 'Description' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set DimensionSetJson SAFTImportCustomer
Updates the value of attribute 'DimensionSetJson' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set DimensionSetJson SAFTImportItem
Updates the value of attribute 'DimensionSetJson' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set DocumentsVerified SAFTImport
Updates the value of attribute 'DocumentsVerified' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Email SAFTImportCustomer
Updates the value of attribute 'Email' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set EndDate SAFTImport
Updates the value of attribute 'EndDate' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (DateTime) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ExistingNif SAFTImportCustomer
Updates the value of attribute 'ExistingNif' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Fax SAFTImportCustomer
Updates the value of attribute 'Fax' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Filename SAFTImport
Updates the value of attribute 'Filename' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set FirstDocumentDate SAFTImport
Updates the value of attribute 'FirstDocumentDate' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (DateTime) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsActive SAFTImport
Updates the value of attribute 'IsActive' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
PUT Set IsVerifyingCustomers SAFTImport
Updates the value of attribute 'IsVerifyingCustomers' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsVerifyingDocuments SAFTImport
Updates the value of attribute 'IsVerifyingDocuments' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set IsVerifyingItems SAFTImport
Updates the value of attribute 'IsVerifyingItems' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemAccountType SAFTImportItem
Updates the value of attribute 'ItemAccountType' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemKey SAFTImportItem
Updates the value of attribute 'ItemKey' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemsVerified SAFTImport
Updates the value of attribute 'ItemsVerified' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemTaxSchema SAFTImportItem
Updates the value of attribute 'ItemTaxSchema' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemType SAFTImportItem
Updates the value of attribute 'ItemType' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (enum ItemType) The request body should contain the new value for the attribute. See ItemType. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ItemWithholdingTaxSchema SAFTImportItem
Updates the value of attribute 'ItemWithholdingTaxSchema' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set LastDocumentDate SAFTImport
Updates the value of attribute 'LastDocumentDate' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (DateTime) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Name SAFTImportCustomer
Updates the value of attribute 'Name' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set OtherReceivable SAFTImportCustomer
Updates the value of attribute 'OtherReceivable' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (bool) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PartyAccountType SAFTImportCustomer
Updates the value of attribute 'PartyAccountType' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set PartyKey SAFTImportCustomer
Updates the value of attribute 'PartyKey' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProductCode SAFTImportItem
Updates the value of attribute 'ProductCode' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProductDescription SAFTImportItem
Updates the value of attribute 'ProductDescription' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProductGroup SAFTImportItem
Updates the value of attribute 'ProductGroup' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProductNumberCode SAFTImportItem
Updates the value of attribute 'ProductNumberCode' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set ProductType SAFTImportItem
Updates the value of attribute 'ProductType' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set SAFTImportRequest SAFTImport
Updates the value of attribute 'SAFTImportRequest' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set SAFTImportStatus SAFTImport
Updates the value of attribute 'SAFTImportStatus' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (enum SAFTImportStatus) The request body should contain the new value for the attribute. See SAFTImportStatus. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set SelfBillingIndicator SAFTImportCustomer
Updates the value of attribute 'SelfBillingIndicator' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set StartDate SAFTImport
Updates the value of attribute 'StartDate' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (DateTime) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TaxRegistrationNumber SAFTImport
Updates the value of attribute 'TaxRegistrationNumber' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Telephone SAFTImportCustomer
Updates the value of attribute 'Telephone' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalCustomers SAFTImport
Updates the value of attribute 'TotalCustomers' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalCustomersImported SAFTImport
Updates the value of attribute 'TotalCustomersImported' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalDocuments SAFTImport
Updates the value of attribute 'TotalDocuments' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalDocumentsImported SAFTImport
Updates the value of attribute 'TotalDocumentsImported' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalItems SAFTImport
Updates the value of attribute 'TotalItems' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set TotalItemsImported SAFTImport
Updates the value of attribute 'TotalItemsImported' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
value | (int) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Unit SAFTImportItem
Updates the value of attribute 'Unit' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
PUT Set Website SAFTImportCustomer
Updates the value of attribute 'Website' in the specified entity record.
The following elements are required:
sAFTImportKey | (int) Number. |
lineId | (string) The detail identifier. |
companyKey | (string) The company key. |
value | (string) The request body should contain the new value for the attribute. |
Response:
When successful, the response body is empty. |
Response status codes:
200 | OK. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
Resource URL:
DELETE SAFT Import Item by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
lineId | (string) The line identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE SAFT Import Customer by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
sAFTImportKey | (int) Number. |
companyKey | (string) The company key. |
lineId | (string) The line identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | NoContent. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE SAFTImport by identifier
Deletes the entity record that matches the specified identifier.
The following elements are required:
id | (string) The record identifier. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
DELETE SAFTImport by key
Deletes the entity record that matches the specified key.
The following elements are required:
companyKey | (string) The company key. |
sAFTImportKey | (int) Number. |
Response:
When successful, the response body is empty. |
Response status codes:
204 | Deleted. The operation was completed successfully. |
400 | BadRequest. The request parameters are invalid. |
404 | NotFound. The specified record does not exist. |
Resource URL:
Resources
ApiSAFTImportResource
The following elements are required:
taxRegistrationNumber | (string) Tax Registration Number. |
sAFTImportStatus | (enum SAFTImportStatus) Status.
See SAFTImportStatus. |
sAFTImportRequest | (string) SAFT Import Request. |
company | (string) Company. |
The following elements are optional:
filename | (string) Filename. |
firstDocumentDate | (DateTime) First Document Date. |
lastDocumentDate | (DateTime) Last Document Date. |
totalDocuments | (int) Total Documents. |
totalCustomers | (int) Total Customers. |
totalItems | (int) Total Items. |
totalDocumentsImported | (int) Total Documents Imported. |
totalCustomersImported | (int) Total Customers Imported. |
totalItemsImported | (int) Total Items Imported. |
sAFTImportItems | (List of ApiSAFTImportSAFTImportItemsResource) SAFT Import Items.
See ApiSAFTImportSAFTImportItemsResource. |
sAFTImportCustomers | (List of ApiSAFTImportSAFTImportCustomersResource) SAFT Import Customers.
See ApiSAFTImportSAFTImportCustomersResource. |
startDate | (DateTime) Start Date. |
endDate | (DateTime) End Date. |
isVerifyingCustomers | (bool) Is Verifying Customers. |
customersVerified | (string) Customers Verified. |
isVerifyingItems | (bool) Is Verifying Items. |
itemsVerified | (string) Items Verified. |
isVerifyingDocuments | (bool) Is Verifying Documents. |
documentsVerified | (string) Documents Verified. |
ApiSAFTImportSAFTImportCustomersResource
The following elements are required:
customerGroup | (string) Customer Group. |
partyAccountType | (string) Party Account Type. |
selfBillingIndicator | (int) Self Billing Indicator. |
existingNif | (bool) Existing Nif. |
The following elements are optional:
partyKey | (string) Party. |
name | (string) Name. |
customerID | (string) Customer ID. |
accountID | (string) Account ID. |
customerTaxID | (string) Customer Tax ID. |
companyName | (string) Company Name. |
telephone | (string) Telephone. |
(string) Email. | |
website | (string) Website. |
otherReceivable | (bool) Other Receivable. |
addressBuildingNumber | (string) Address Building Number. |
addressStreetName | (string) Address Street Name. |
addressDetail | (string) Address Detail. |
addressCity | (string) Address City. |
addressPostalCode | (string) Address Postal. |
addressRegion | (string) Address Region. |
addressCountry | (string) Address Country. |
fax | (string) Fax. |
cae | (string) Cae. |
dimensionSetJson | (string) The party dimension set configuration. |
ApiSAFTImportSAFTImportItemsResource
The following elements are required:
itemKey | (string) Item. |
itemAccountType | (string) Item Account Type. |
itemTaxSchema | (string) Item Tax Schema. |
The following elements are optional:
productCode | (string) Product. |
productType | (string) Product Type. |
productDescription | (string) Product Description. |
productGroup | (string) Product Group. |
productNumberCode | (string) Product Number. |
description | (string) Description. |
itemType | (enum ItemType) Item Type.
See ItemType. |
unit | (string) Unit. |
itemWithholdingTaxSchema | (string) Item Withholding Tax Schema. |
dimensionSetJson | (string) The item dimension set configuration. |
PartiesWithoutCustomersExtensions
The following elements are required:
partyKey | (string) The key of the party. |
The following elements are optional:
customerGroupId | (Guid) The customer group identifier of the saft import customer. |
baseEntityId | (Guid) The base entity identifier of the party. |
customerTaxId | (string) The customer tax id. |
otherReceivable | (bool) if the party is customer or Other Receivable. |
SAFTImportCustomerResource
The following elements are required:
customerGroup | (string) Customer Group. |
partyAccountType | (string) Party Account Type. |
selfBillingIndicator | (int) Self Billing Indicator. |
existingNif | (bool) Existing Nif. |
The following elements are optional:
partyKey | (string) Party. |
name | (string) Name. |
customerID | (string) Customer ID. |
accountID | (string) Account ID. |
customerTaxID | (string) Customer Tax ID. |
companyName | (string) Company Name. |
telephone | (string) Telephone. |
(string) Email. | |
website | (string) Website. |
otherReceivable | (bool) Other Receivable. |
addressBuildingNumber | (string) Address Building Number. |
addressStreetName | (string) Address Street Name. |
addressDetail | (string) Address Detail. |
addressCity | (string) Address City. |
addressPostalCode | (string) Address Postal. |
addressRegion | (string) Address Region. |
addressCountry | (string) Address Country. |
fax | (string) Fax. |
cae | (string) Cae. |
dimensionSetJson | (string) The party dimension set configuration. |
SAFTImportItemResource
The following elements are required:
itemKey | (string) Item. |
itemAccountType | (string) Item Account Type. |
itemTaxSchema | (string) Item Tax Schema. |
The following elements are optional:
productCode | (string) Product. |
productType | (string) Product Type. |
productDescription | (string) Product Description. |
productGroup | (string) Product Group. |
productNumberCode | (string) Product Number. |
description | (string) Description. |
itemType | (enum ItemType) Item Type.
See ItemType. |
unit | (string) Unit. |
itemWithholdingTaxSchema | (string) Item Withholding Tax Schema. |
dimensionSetJson | (string) The item dimension set configuration. |
SAFTImportResource
The following elements are required:
sAFTImportKey | (int) Number. |
taxRegistrationNumber | (string) Tax Registration Number. |
sAFTImportStatus | (enum SAFTImportStatus) Status.
See SAFTImportStatus. |
sAFTImportRequest | (string) SAFT Import Request.
(fk) Allowed value: the natural key of a record of type SAFTImportRequest. These records are accessibly through the SAFTImportRequests service. |
company | (string) Company.
(fk) Allowed value: the natural key of a record of type Company. These records are accessibly through the Companies service. |
The following elements are optional:
filename | (string) Filename. |
firstDocumentDate | (DateTime) First Document Date. |
lastDocumentDate | (DateTime) Last Document Date. |
totalDocuments | (int) Total Documents. |
totalCustomers | (int) Total Customers. |
totalItems | (int) Total Items. |
totalDocumentsImported | (int) Total Documents Imported. |
totalCustomersImported | (int) Total Customers Imported. |
totalItemsImported | (int) Total Items Imported. |
sAFTImportItems | (List of SAFTImportItemResource) SAFT Import Items.
See SAFTImportItemResource. |
sAFTImportCustomers | (List of SAFTImportCustomerResource) SAFT Import Customers.
See SAFTImportCustomerResource. |
startDate | (DateTime) Start Date. |
endDate | (DateTime) End Date. |
isVerifyingCustomers | (bool) Is Verifying Customers. |
customersVerified | (string) Customers Verified. |
isVerifyingItems | (bool) Is Verifying Items. |
itemsVerified | (string) Items Verified. |
isVerifyingDocuments | (bool) Is Verifying Documents. |
documentsVerified | (string) Documents Verified. |
StandardSAFTImportResource
The following elements are required:
sAFTImportKey | (int) Number. |
company | (string) Company. |
sAFTImportRequest | (string) SAFT Import Request. |
The following elements are optional:
sAFTImportCustomers | (List of StandardSAFTImportSAFTImportCustomersResource) SAFT Import Customers.
See StandardSAFTImportSAFTImportCustomersResource. |
customersVerified | (string) Customers Verified. |
documentsVerified | (string) Documents Verified. |
isVerifyingCustomers | (bool) Is Verifying Customers. |
isVerifyingDocuments | (bool) Is Verifying Documents. |
isVerifyingItems | (bool) Is Verifying Items. |
itemsVerified | (string) Items Verified. |
sAFTImportItems | (List of StandardSAFTImportSAFTImportItemsResource) SAFT Import Items.
See StandardSAFTImportSAFTImportItemsResource. |
totalCustomers | (int) Total Customers. |
totalCustomersImported | (int) Total Customers Imported. |
totalDocuments | (int) Total Documents. |
totalDocumentsImported | (int) Total Documents Imported. |
totalItems | (int) Total Items. |
totalItemsImported | (int) Total Items Imported. |
StandardSAFTImportSAFTImportCustomersResource
The following elements are required:
customerGroup | (string) Customer Group. |
partyAccountType | (string) Party Account Type. |
existingNif | (bool) Existing Nif. |
The following elements are optional:
customerID | (string) Customer ID. |
customerTaxID | (string) Customer Tax ID. |
dimensionSetJson | (string) The party dimension set configuration. |
name | (string) Name. |
otherReceivable | (bool) Other Receivable. |
StandardSAFTImportSAFTImportItemsResource
The following elements are required:
itemAccountType | (string) Item Account Type. |
itemKey | (string) Item. |
itemTaxSchema | (string) Item Tax Schema. |
The following elements are optional:
description | (string) Description. |
dimensionSetJson | (string) The item dimension set configuration. |
itemType | (enum ItemType) Item Type.
See ItemType. |
itemWithholdingTaxSchema | (string) Item Withholding Tax Schema. |
unit | (string) Unit. |