Contribuyentes
Crear por CIEC
Registra un contribuyente por CIEC (Clave de Identificación Electrónica para el Contribuyente).
Para registrar un contribuyente utilizando credenciales CIEC, realiza una petición POST al endpoint de taxpayers. Las credenciales se envían como Base64 de RFC:password.
El valor de
credential debe ser RFC:password codificado en base64. Ejemplo: base64("AOBE910907K45:MiPassword123")Endpoint
POST /taxpayers
Content-Type: application/json
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
credential | string | sí | Base64 de RFC:password (ej. base64("AOBE910907K45:MiPassword123")) |
byPassCheckCredential | boolean | no | Si true, no valida contra SAT. Default: false |
Respuesta 200
{
"status": "success",
"data": {
"id": "40b86d76-6758-45d8-ab02-db8f5e0d8687",
"fullName": "SUAREZ CORO BRYAN BOLIVAR",
"identification": "AOBE910907K45",
"priority": 0,
"status": "ACTIVE",
"createdAt": "2026-03-09T18:15:46.000Z",
"contacts": [{"kind": "EMAIL", "value": "[email protected]"}],
"legalRepresentative": null,
"registrationType": "CIEC"
}
}
Ejemplo curl
curl --location 'https://api.taxo.ws/taxpayers' \
--header 'Content-Type: application/json' \
--header 'x-api-key: TU_API_KEY' \
--data '{
"credential": "R09DSTk2MDQzMFI2NTpKbjdzdWQzOQ==",
"byPassCheckCredential": false
}'
Código de Ejemplo
Javascript
const axios = require('axios');
const data = JSON.stringify({
credential: btoa('AOBE910907K45:MiPassword123'),
byPassCheckCredential: false
});
const config = {
method: 'post',
url: 'https://api.taxo.ws/taxpayers',
headers: {
'x-api-key': 'TU_API_KEY',
'Content-Type': 'application/json'
},
data
};
axios.request(config)
.then((response) => console.log(JSON.stringify(response.data)))
.catch((error) => console.error(error));