Update your tax issuer
curl --request PATCH \
--url https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer \
--header 'Content-Type: application/json' \
--data '
{
"homologationProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": false,
"isSimplesNacional": true,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
},
"productionProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": false,
"isSimplesNacional": true,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
}
}
'import requests
url = "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer"
payload = {
"homologationProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": False,
"isSimplesNacional": True,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
},
"productionProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": False,
"isSimplesNacional": True,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
homologationProperties: {
specialTaxCode: 1,
municipalServiceCode: '0107',
serviceListItem: '1.07',
issTax: 2.5,
serviceDescription: 'Licenciamento de software como serviço (SaaS)',
hasCulturalIncentive: false,
isSimplesNacional: true,
nfeSequencialCode: 1,
nfeSeries: '1',
nfeSequencialBatch: 1,
cnae: 6201501,
taxConfiguration: {
nbsCode: '115090000',
nationalTaxCode: '010701',
taxClassification: '000001',
operationIndicatorCode: '100301'
}
},
productionProperties: {
specialTaxCode: 1,
municipalServiceCode: '0107',
serviceListItem: '1.07',
issTax: 2.5,
serviceDescription: 'Licenciamento de software como serviço (SaaS)',
hasCulturalIncentive: false,
isSimplesNacional: true,
nfeSequencialCode: 1,
nfeSeries: '1',
nfeSequencialBatch: 1,
cnae: 6201501,
taxConfiguration: {
nbsCode: '115090000',
nationalTaxCode: '010701',
taxClassification: '000001',
operationIndicatorCode: '100301'
}
}
})
};
fetch('https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'homologationProperties' => [
'specialTaxCode' => 1,
'municipalServiceCode' => '0107',
'serviceListItem' => '1.07',
'issTax' => 2.5,
'serviceDescription' => 'Licenciamento de software como serviço (SaaS)',
'hasCulturalIncentive' => false,
'isSimplesNacional' => true,
'nfeSequencialCode' => 1,
'nfeSeries' => '1',
'nfeSequencialBatch' => 1,
'cnae' => 6201501,
'taxConfiguration' => [
'nbsCode' => '115090000',
'nationalTaxCode' => '010701',
'taxClassification' => '000001',
'operationIndicatorCode' => '100301'
]
],
'productionProperties' => [
'specialTaxCode' => 1,
'municipalServiceCode' => '0107',
'serviceListItem' => '1.07',
'issTax' => 2.5,
'serviceDescription' => 'Licenciamento de software como serviço (SaaS)',
'hasCulturalIncentive' => false,
'isSimplesNacional' => true,
'nfeSequencialCode' => 1,
'nfeSeries' => '1',
'nfeSequencialBatch' => 1,
'cnae' => 6201501,
'taxConfiguration' => [
'nbsCode' => '115090000',
'nationalTaxCode' => '010701',
'taxClassification' => '000001',
'operationIndicatorCode' => '100301'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer"
payload := strings.NewReader("{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer")
.header("Content-Type", "application/json")
.body("{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_CONFIGURATION_INCOMPLETE",
"origin": "ACCOUNTING",
"message": "The fields `Tax Situation` and `Tax Classification` are mandatory for issuers that are not of the `Simples Nacional` type. The fields `codigoTributacaoNacional` and `codigoNBS` are optional."
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_ISSUER_INACTIVE",
"origin": "ACCOUNTING",
"message": "Tax issuer is deactivated. You do not have permission to perform this action."
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_ISSUER_NOT_FOUND",
"origin": "ACCOUNTING",
"message": "Tax issuer not found"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "ACCOUNTING",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "homologationProperties",
"message": "Invalid input: expected object, received undefined",
"code": "HOMOLOGATIONPROPERTIES_REQUIRED"
}
]
}Update your tax issuer
Updates the configuration of the tax issuer of the organization, in both environments.
PATCH
/
realms
/
{realmId}
/
organizations
/
{organizationId}
/
tax-issuer
Update your tax issuer
curl --request PATCH \
--url https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer \
--header 'Content-Type: application/json' \
--data '
{
"homologationProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": false,
"isSimplesNacional": true,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
},
"productionProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": false,
"isSimplesNacional": true,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
}
}
'import requests
url = "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer"
payload = {
"homologationProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": False,
"isSimplesNacional": True,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
},
"productionProperties": {
"specialTaxCode": 1,
"municipalServiceCode": "0107",
"serviceListItem": "1.07",
"issTax": 2.5,
"serviceDescription": "Licenciamento de software como serviço (SaaS)",
"hasCulturalIncentive": False,
"isSimplesNacional": True,
"nfeSequencialCode": 1,
"nfeSeries": "1",
"nfeSequencialBatch": 1,
"cnae": 6201501,
"taxConfiguration": {
"nbsCode": "115090000",
"nationalTaxCode": "010701",
"taxClassification": "000001",
"operationIndicatorCode": "100301"
}
}
}
headers = {"Content-Type": "application/json"}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
homologationProperties: {
specialTaxCode: 1,
municipalServiceCode: '0107',
serviceListItem: '1.07',
issTax: 2.5,
serviceDescription: 'Licenciamento de software como serviço (SaaS)',
hasCulturalIncentive: false,
isSimplesNacional: true,
nfeSequencialCode: 1,
nfeSeries: '1',
nfeSequencialBatch: 1,
cnae: 6201501,
taxConfiguration: {
nbsCode: '115090000',
nationalTaxCode: '010701',
taxClassification: '000001',
operationIndicatorCode: '100301'
}
},
productionProperties: {
specialTaxCode: 1,
municipalServiceCode: '0107',
serviceListItem: '1.07',
issTax: 2.5,
serviceDescription: 'Licenciamento de software como serviço (SaaS)',
hasCulturalIncentive: false,
isSimplesNacional: true,
nfeSequencialCode: 1,
nfeSeries: '1',
nfeSequencialBatch: 1,
cnae: 6201501,
taxConfiguration: {
nbsCode: '115090000',
nationalTaxCode: '010701',
taxClassification: '000001',
operationIndicatorCode: '100301'
}
}
})
};
fetch('https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PATCH",
CURLOPT_POSTFIELDS => json_encode([
'homologationProperties' => [
'specialTaxCode' => 1,
'municipalServiceCode' => '0107',
'serviceListItem' => '1.07',
'issTax' => 2.5,
'serviceDescription' => 'Licenciamento de software como serviço (SaaS)',
'hasCulturalIncentive' => false,
'isSimplesNacional' => true,
'nfeSequencialCode' => 1,
'nfeSeries' => '1',
'nfeSequencialBatch' => 1,
'cnae' => 6201501,
'taxConfiguration' => [
'nbsCode' => '115090000',
'nationalTaxCode' => '010701',
'taxClassification' => '000001',
'operationIndicatorCode' => '100301'
]
],
'productionProperties' => [
'specialTaxCode' => 1,
'municipalServiceCode' => '0107',
'serviceListItem' => '1.07',
'issTax' => 2.5,
'serviceDescription' => 'Licenciamento de software como serviço (SaaS)',
'hasCulturalIncentive' => false,
'isSimplesNacional' => true,
'nfeSequencialCode' => 1,
'nfeSeries' => '1',
'nfeSequencialBatch' => 1,
'cnae' => 6201501,
'taxConfiguration' => [
'nbsCode' => '115090000',
'nationalTaxCode' => '010701',
'taxClassification' => '000001',
'operationIndicatorCode' => '100301'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer"
payload := strings.NewReader("{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}")
req, _ := http.NewRequest("PATCH", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.patch("https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer")
.header("Content-Type", "application/json")
.body("{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.accounting.v2.portao3.com.br/realms/{realmId}/organizations/{organizationId}/tax-issuer")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Patch.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"homologationProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n },\n \"productionProperties\": {\n \"specialTaxCode\": 1,\n \"municipalServiceCode\": \"0107\",\n \"serviceListItem\": \"1.07\",\n \"issTax\": 2.5,\n \"serviceDescription\": \"Licenciamento de software como serviço (SaaS)\",\n \"hasCulturalIncentive\": false,\n \"isSimplesNacional\": true,\n \"nfeSequencialCode\": 1,\n \"nfeSeries\": \"1\",\n \"nfeSequencialBatch\": 1,\n \"cnae\": 6201501,\n \"taxConfiguration\": {\n \"nbsCode\": \"115090000\",\n \"nationalTaxCode\": \"010701\",\n \"taxClassification\": \"000001\",\n \"operationIndicatorCode\": \"100301\"\n }\n }\n}"
response = http.request(request)
puts response.read_body{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_CONFIGURATION_INCOMPLETE",
"origin": "ACCOUNTING",
"message": "The fields `Tax Situation` and `Tax Classification` are mandatory for issuers that are not of the `Simples Nacional` type. The fields `codigoTributacaoNacional` and `codigoNBS` are optional."
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_ISSUER_INACTIVE",
"origin": "ACCOUNTING",
"message": "Tax issuer is deactivated. You do not have permission to perform this action."
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "TAX_ISSUER_NOT_FOUND",
"origin": "ACCOUNTING",
"message": "Tax issuer not found"
}{
"traceId": "1-68ee2a1b-3c4d5e6f7a8b9c0d1e2f3a4b",
"code": "BAD_REQUEST",
"origin": "ACCOUNTING",
"message": "Bad Request: Your request is invalid or incomplete. Please make sure you are requesting with the right fields.",
"fields": [
{
"field": "homologationProperties",
"message": "Invalid input: expected object, received undefined",
"code": "HOMOLOGATIONPROPERTIES_REQUIRED"
}
]
}This replaces the configuration of the
TEST (homologation) and the LIVE (production) environment, so send both homologationProperties and productionProperties in full. The organization’s own data (CNPJ, legal name, address, phone) is taken again from its registration in Portão 3 and sent to the tax provider together with the new configuration. Omitting a taxConfiguration keeps the stored one.
The RPS numbers you send (nfeSequencialCode, nfeSequencialBatch) restart the tax provider’s numbering for that environment. Get your tax issuer returns the numbers set last, not the current ones (they are not advanced as documents are issued), so send the number your city hall expects next — never the value read back unchanged.
When isSimplesNacional is false in an environment, the taxConfiguration of that environment must carry taxClassification, operationIndicatorCode and nationalTaxCode. The value of isSimplesNacional in productionProperties is the one registered with the tax provider. The tax issuer must be active.
If the tax provider rejects the request, the error is returned with the provider’s error code and a status of 400, 409, 422 or 502.Path Parameters
ID of your realm.
Format: UUID
ID of the organization.
Format: UUID
Body
application/json
Configuration of the test (homologation) environment: documents issued here have no fiscal value. Replaces the stored configuration, so send every field.
Show child attributes
Show child attributes
Configuration of the live (production) environment: documents issued here are legally valid. Replaces the stored configuration, so send every field.
Show child attributes
Show child attributes
Response
No Content. The operation succeeded and the response has no body.