Country Parameters

📋 Full base request → createAccount

All countries use the same createAccount base structure. This page documents only the per-country delta: which nodes are required and the specific content of taxEntity. Navigate the index on the right to go directly to a country.

Node	When it applies
accountUser	Always — identical structure for all countries
certificateRootDto	Only countries marked with ✅ in the TR index table
taxEntity	Only countries marked with ✅ — see the sections below

---

🇦🇷 Argentina

Specifics

• Does not require certificateRootDto or taxEntity. The body is reduced to only the accountUser node.
• The delegation before ARCa (AFIP) must be done manually or assisted by the consultancy for each TaxId that is integrated.

The Argentina request is the only one that completely omits certificateRootDto. See createAccount and exclude that node.

---

🇧🇴 Bolivia

Specifics

• Requires a digital certificate in Base64 and its password (certificateRootDto).
• Requires taxEntity with a Gosocket-ISIPASS interoperability token. It is not the delegated SIAT/SIN token; that token is consumed by ISIPASS when connecting to the tax authority.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityBo.token	string	Required	Gosocket-ISIPASS interoperability token.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_BO}}",
  "email": "admin@empresa.com",
  "countryId": "bo",
  "taxEntityBo": {
    "token": "TOKEN_GOSOCKET-ISIPASS"
  }
}

---

🇧🇷 Brazil

Specifics

• Requires a digital certificate in Base64 and its password (certificateRootDto).
• Requires taxEntity with SEFAZ/NDD credentials and reception email configuration.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityBr.ndd	boolean	Required	true: NDD integration active. false: not integrated with NDD.
taxEntityBr.user	string	Required	NDD connectivity user.
taxEntityBr.password	string	Required	NDD connectivity password.
taxEntityBr.emailsReception	array	Required	List of emails by document type (documentTypeId, documentType, emails), shared by NDD for each customer.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_BR}}",
  "email": "admin@empresa.com",
  "countryId": "br",
  "taxEntityBr": {
    "ndd": false,
    "user": "USUARIO_SEFAZ",
    "password": "PASS_SEFAZ",
    "emailsReception": [
      { "documentTypeId": 55, "documentType": "NF-e", "emails": "nfe@empresa.com.br" },
      { "documentTypeId": 57, "documentType": "CT-e", "emails": "cte@empresa.com.br" },
      { "documentTypeId": 58, "documentType": "MDF-e", "emails": "mdfe@empresa.com.br" }
    ]
  }
}

---

🇨🇱 Chile

Specifics

• TR reference country: the Partner credentials (partnerId / apiKeyUser) are created for Chile and reused across all countries.
• The digital certificate is a .pfx file converted to Base64. certKeyBase64 is left empty.
• Does not require taxEntity.

---

🇨🇴 Colombia

Specifics

• .pfx digital certificate in Base64. certKeyBase64 is left empty.
• Does not require taxEntity.

---

🇨🇷 Costa Rica

Specifics

• .p12 certificate downloaded from the ATV portal of the Ministry of Finance (https://www.hacienda.go.cr/ATV/login.aspx), converted to Base64. The password (certificateRootDto.password) is the 4-digit PIN entered when generating it.
• The taxEntity credentials are Electronic Receipts credentials generated in ATV — they are not the ATV login credentials.
• The cryptographic key is generated in ATV → Electronic Receipts → Cryptographic Key → Generate.
• Applicable resolution: DGT-R-48-2016 of the Ministry of Finance.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityCr.user	string	Required	Login identification for electronic receipts (e.g.: cpf-01-XXXX-XXXX@pro). Obtained in ATV → Electronic Receipts → Generate new password. It is not the ATV login user.
taxEntityCr.password	string	Required	Electronic receipts password. It is not the ATV login password. Generate only once.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_CR}}",
  "email": "admin@empresa.com",
  "countryId": "cr",
  "taxEntityCr": {
    "user": "cpf-01-XXXX-XXXX@pro",
    "password": "PASS_COMPROBANTES_ATV"
  }
}

---

🇪🇨 Ecuador

Specifics

• .p12/.pfx certificate in Base64, issued by an entity authorized by the SRI. certKeyBase64 is left empty.
• Does not require taxEntity.

---

🇸🇻 El Salvador

Specifics

• Requires a digital certificate in Base64 and its password.
• Requires taxEntity with credentials from the Ministry of Finance (MH) portal.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntitySv.user	string	Required	El Salvador MH portal user.
taxEntitySv.pwd	string	Required	El Salvador MH portal password.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_SV}}",
  "email": "admin@empresa.com",
  "countryId": "sv",
  "taxEntitySv": {
    "user": "USUARIO_MH_SV",
    "pwd": "PASS_MH_SV"
  }
}

---

🇬🇹 Guatemala

Specifics

• Requires a digital certificate in Base64.
• Requires taxEntity with credentials obtained from MegaPrint (SAT Virtual Agency).

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityGt.user	string	Required	SAT Virtual Agency portal user.
taxEntityGt.password	string	Required	SAT Virtual Agency portal password.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_GT}}",
  "email": "admin@empresa.com",
  "countryId": "gt",
  "taxEntityGt": {
    "user": "USUARIO_SAT_GT",
    "password": "PASS_SAT_GT"
  }
}

---

🇲🇽 México

Specifics

• CSD-type certificate (.cer extension) in Base64. FIEL type is not used.
• certKeyBase64 carries the .key file in Base64. certKeyBase64 is required for México.
• Does not require taxEntity.

---

🇵🇦 Panamá

Specifics

• X.509 version 3 certificate in Base64, issued by a Certification Authority accredited before the Public Registry of Panamá.
• Requires taxEntity with RUC and DGI security code.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityPa.identifier	string	Required	Panamanian RUC including the Verification Digit (DV). Must match the RUC embedded in the certificate (OID=2.16.591.1.1.2.2).
taxEntityPa.securityCode	string	Required	Security code assigned by the DGI upon being enabled as an electronic issuer.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_PA}}",
  "email": "admin@empresa.com",
  "countryId": "pa",
  "taxEntityPa": {
    "identifier": "{{RUC_DV_PANAMA}}",
    "securityCode": "{{SECURITY_CODE_DGI}}"
  }
}

---

🇵🇾 Paraguay

Specifics

• Requires a digital certificate in Base64. certKeyBase64 is left empty.
• Requires taxEntity with SIFEN (Sistema Integrado de Facturación Electrónica Nacional) credentials from the SET.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityPy.idCSS	string	Required	CSS identifier assigned by the SET. Obtained when requesting the Production stamping (timbrado); generic values are used in testing.
taxEntityPy.css	string	Required	Content of the taxpayer's CSS signature file. Obtained when requesting the Production stamping (timbrado); generic values are used in testing.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_PY}}",
  "email": "admin@empresa.com",
  "countryId": "py",
  "taxEntityPy": {
    "idCSS": "ID_CSS_SET",
    "css": "CONTENIDO_CSS_FIRMA"
  }
}

---

🇵🇪 Perú

Specifics

• Requires a digital certificate in Base64 and its password.
• Requires taxEntity with SOL (SUNAT Operaciones en Línea) credentials.

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityPe.userSol	string	Required	SUNAT SOL user.
taxEntityPe.passSol	string	Required	SUNAT SOL password.
taxEntityPe.identifier	string	Required	Company RUC (20 digits).
taxEntityPe.dispatchIsSync	boolean	Required	true = synchronous sending / false = asynchronous.
taxEntityPe.dailyReportMaxCount	integer	Required	Maximum documents per daily report.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_PE}}",
  "email": "admin@empresa.com",
  "countryId": "pe",
  "taxEntityPe": {
    "userSol": "USUARIO_SOL",
    "passSol": "PASS_SOL",
    "identifier": "{{RUC_EMPRESA}}",
    "dispatchIsSync": true,
    "dailyReportMaxCount": 100
  }
}

---

🇩🇴 República Dominicana

Specifics

• Requires a digital certificate in Base64 and its password.
• Requires taxEntity with the certification field (boolean).

taxEntity-specific fields

Field	Type	Req.	Description
taxEntityDo.certification	boolean	Required	In production always false. In testing: true = DGII certification mode / false = standard testing.

taxEntity node

"taxEntity": {
  "taxId": "{{taxId_DO}}",
  "email": "admin@empresa.com",
  "countryId": "do",
  "taxEntityDo": {
    "certification": false
  }
}

---

🇺🇾 Uruguay

Specifics

• Requires a digital certificate in Base64 and its password.
• Does not require taxEntity.