Onboarding por País

📋 Request base completo → createAccount

Todos los países usan la misma estructura base de createAccount. Esta página documenta únicamente el delta por país: qué nodos son requeridos y el contenido específico de taxEntity. Navega por el índice de la derecha para ir directo al país.

Nodo	Cuándo aplica
accountUser	Siempre — estructura idéntica para todos los países
certificateRootDto	Solo países marcados con ✅ en la tabla de índice TR
taxEntity	Solo países marcados con ✅ — ver secciones a continuación

---

🇦🇷 Argentina

Particularidades

• No requiere certificateRootDto ni taxEntity. El body se reduce a solo el nodo accountUser.
• La delegación ante ARCa (AFIP) debe realizarse de forma manual o asistida por la consultoría para cada TaxId que se integre.

El request de Argentina es el único que omite completamente certificateRootDto. Ver createAccount y excluir ese nodo.

---

🇧🇴 Bolivia

Particularidades

• Requiere certificado digital en Base64 y su contraseña (certificateRootDto).
• Requiere taxEntity con token de interoperabilidad Gosocket-ISIPASS. No es el token delegado de SIAT/SIN; ese token lo consume ISIPASS al conectarse con la entidad tributaria.

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityBo.token	string	Requerido	Token de interoperabilidad Gosocket-ISIPASS.

Nodo taxEntity

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

---

🇧🇷 Brasil

Particularidades

• Requiere certificado digital en Base64 y su contraseña (certificateRootDto).
• Requiere taxEntity con credenciales SEFAZ/NDD y configuración de correos de recepción.

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityBr.ndd	boolean	Requerido	true: integración con NDD activa. false: no integrado con NDD.
taxEntityBr.user	string	Requerido	Usuario de conectividad con NDD.
taxEntityBr.password	string	Requerido	Contraseña de conectividad con NDD.
taxEntityBr.emailsReception	array	Requerido	Lista de correos por tipo de documento (documentTypeId, documentType, emails), compartidos por NDD para cada cliente.

Nodo taxEntity

"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

Particularidades

• País de referencia TR: las credenciales del Partner (partnerId / apiKeyUser) se crean para Chile y se reutilizan en todos los países.
• El certificado digital es un archivo .pfx convertido a Base64. certKeyBase64 va vacío.
• No requiere taxEntity.

---

🇨🇴 Colombia

Particularidades

• Certificado digital .pfx en Base64. certKeyBase64 va vacío.
• No requiere taxEntity.

---

🇨🇷 Costa Rica

Particularidades

• Certificado .p12 descargado desde el portal ATV del Ministerio de Hacienda (https://www.hacienda.go.cr/ATV/login.aspx), convertido a Base64. La contraseña (certificateRootDto.password) es el PIN de 4 dígitos ingresado al generarlo.
• Las credenciales de taxEntity son de Comprobantes Electrónicos generadas en ATV — no son las credenciales de login de ATV.
• La llave criptográfica se genera en ATV → Comprobantes Electrónicos → Llave Criptográfica → Generar.
• Resolución aplicable: DGT-R-48-2016 del Ministerio de Hacienda.

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityCr.user	string	Requerido	Identificación de ingreso para comprobantes electrónicos (ej: cpf-01-XXXX-XXXX@pro). Obtenida en ATV → Comprobantes Electrónicos → Generar nueva contraseña. No es el usuario de login ATV.
taxEntityCr.password	string	Requerido	Contraseña de comprobantes electrónicos. No es la contraseña de login ATV. Generar una sola vez.

Nodo taxEntity

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

---

🇪🇨 Ecuador

Particularidades

• Certificado .p12/.pfx en Base64, emitido por entidad autorizada por el SRI. certKeyBase64 va vacío.
• No requiere taxEntity.

---

🇸🇻 El Salvador

Particularidades

• Requiere certificado digital en Base64 y su contraseña.
• Requiere taxEntity con credenciales del portal del Ministerio de Hacienda (MH).

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntitySv.user	string	Requerido	Usuario del portal MH El Salvador.
taxEntitySv.pwd	string	Requerido	Contraseña del portal MH El Salvador.

Nodo taxEntity

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

---

🇬🇹 Guatemala

Particularidades

• Requiere certificado digital en Base64.
• Requiere taxEntity con credenciales obtenidas de MegaPrint (Agencia Virtual SAT).

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityGt.user	string	Requerido	Usuario del portal Agencia Virtual SAT.
taxEntityGt.password	string	Requerido	Contraseña del portal Agencia Virtual SAT.

Nodo taxEntity

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

---

🇲🇽 México

Particularidades

• Certificado tipo CSD (extensión .cer) en Base64. No se usa tipo FIEL.
• certKeyBase64 lleva el archivo .key en Base64. certKeyBase64 es requerido para México.
• No requiere taxEntity.

---

🇵🇦 Panamá

Particularidades

• Certificado X.509 versión 3 en Base64, emitido por Autoridad Certificadora acreditada ante el Registro Público de Panamá.
• Requiere taxEntity con RUC y código de seguridad DGI.

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityPa.identifier	string	Requerido	RUC panameño incluyendo Dígito Verificador (DV). Debe coincidir con el RUC embebido en el certificado (OID=2.16.591.1.1.2.2).
taxEntityPa.securityCode	string	Requerido	Código de seguridad asignado por la DGI al habilitarse como emisor electrónico.

Nodo taxEntity

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

---

🇵🇾 Paraguay

Particularidades

• Requiere certificado digital en Base64. certKeyBase64 va vacío.
• Requiere taxEntity con credenciales del SIFEN (Sistema Integrado de Facturación Electrónica Nacional) de la SET.

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityPy.idCSS	string	Requerido	Identificador CSS asignado por la SET. Se obtiene al solicitar el timbrado de Producción; en pruebas se usan valores genéricos.
taxEntityPy.css	string	Requerido	Contenido del archivo de firma CSS del contribuyente. Se obtiene al solicitar el timbrado de Producción; en pruebas se usan valores genéricos.

Nodo taxEntity

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

---

🇵🇪 Perú

Particularidades

• Requiere certificado digital en Base64 y su contraseña.
• Requiere taxEntity con credenciales SOL (SUNAT Operaciones en Línea).

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityPe.userSol	string	Requerido	Usuario SOL de SUNAT.
taxEntityPe.passSol	string	Requerido	Contraseña SOL de SUNAT.
taxEntityPe.identifier	string	Requerido	RUC de la empresa (20 dígitos).
taxEntityPe.dispatchIsSync	boolean	Requerido	true = envío síncrono / false = asíncrono.
taxEntityPe.dailyReportMaxCount	integer	Requerido	Máximo de documentos por reporte diario.

Nodo taxEntity

"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

Particularidades

• Requiere certificado digital en Base64 y su contraseña.
• Requiere taxEntity con el campo certification (boolean).

Campos específicos de taxEntity

Campo	Tipo	Req.	Descripción
taxEntityDo.certification	boolean	Requerido	En producción siempre false. En pruebas: true = modo certificación DGII / false = pruebas estándar.

Nodo taxEntity

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

---

🇺🇾 Uruguay

Particularidades

• Requiere certificado digital en Base64 y su contraseña.
• No requiere taxEntity.