Contribuyentes
1. Subir Certificados FIEL
Paso 1 del registro FIEL. Sube los archivos .cer y .key del certificado a S3.
El upload de certificados FIEL es el primer paso para registrar un taxpayer por FIEL o para asociar FIEL a un taxpayer existente. Este endpoint sube los archivos .cer y .key del certificado a S3 y devuelve las rutas necesarias para el siguiente paso (registrar el contribuyente).
Después de subir los certificados, continúa con Registrar por FIEL (Paso 2).
Endpoint
POST /v1/credentials/upload-certificates/:rfc
| Parámetro | Tipo | Descripción |
|---|---|---|
rfc | string | RFC del contribuyente (12-13 caracteres) |
Content-Type: multipart/form-data
| Campo | Tipo | Descripción |
|---|---|---|
cer | file | Archivo .cer |
key | file | Archivo .key |
Respuesta 201
{
"cer_s3_key": "certificates/AOBE910907K45/AOBE910907K45.cer",
"key_s3_key": "certificates/AOBE910907K45/AOBE910907K45.key",
"fullName": "SUAREZ CORO BRYAN BOLIVAR"
}
El campo
fullName es opcional (extraído del CN del certificado .cer). Si viene en la respuesta, envía este valor en el registro (Paso 2) para que el taxpayer tenga el nombre real del contribuyente.Ejemplo curl
curl --location 'https://api.taxo.ws/v1/credentials/upload-certificates/AOBE910907K45' \
--header 'x-api-key: TU_API_KEY' \
--form 'cer=@"/ruta/a/archivo.cer"' \
--form 'key=@"/ruta/a/archivo.key"'
Ejemplo con Javascript
Javascript
const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');
const form = new FormData();
form.append('cer', fs.createReadStream('/ruta/a/archivo.cer'));
form.append('key', fs.createReadStream('/ruta/a/archivo.key'));
const config = {
method: 'post',
url: 'https://api.taxo.ws/v1/credentials/upload-certificates/AOBE910907K45',
headers: {
'x-api-key': 'TU_API_KEY',
...form.getHeaders()
},
data: form
};
axios.request(config)
.then((response) => console.log(JSON.stringify(response.data)))
.catch((error) => console.error(error));