Paladins APIs

Appearance

Constancia de Situación Fiscal (SAT) ​

Servicio automatizado para generar y descargar en tiempo real la Constancia de Situación Fiscal (CSF) oficial emitida por el Servicio de Administración Tributaria (SAT) en formato PDF / Base64.

POST/api/v1/SAT/CIEC/fiscal-status-certificate

📋 Parámetros de la Solicitud ​

Encabezados ​

http
Authorization: Bearer {TU_TOKEN}
Accept: application/json
Content-Type: application/json

Cuerpo de la Petición (JSON o multipart/form-data) ​

CampoTipoObligatorioDescripción
rfcstringSíRegistro Federal de Contribuyentes (12 o 13 caracteres).
ciecstringSíContraseña CIEC del portal del SAT asociada al RFC.

📤 Respuestas Posibles ​

200 OK — Constancia Generada

json
{
  "data": {
    "rfc": "XAXX010101000",
    "fileBase64": "JVBERi0xLjQKJcOkw7zDtsOfCjIgMCBvYmoK..."
  }
}

401 Unauthorized — Token No Válido

json
{
  "message": "Unauthenticated."
}

422 Unprocessable Content — Credenciales Inválidas

json
{
  "errors": "The provided credentials are invalid."
}

💻 Ejemplos de Integración ​

bash
curl --location 'https://bridge.paladins.mx/api/v1/SAT/CIEC/fiscal-status-certificate' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer {TU_TOKEN}' \
  --data-raw '{
    "rfc": "XAXX010101000",
    "ciec": "TU_PASSWORD_CIEC"
  }'
javascript
import axios from 'axios';
import fs from 'fs';

const response = await axios.post(
  'https://bridge.paladins.mx/api/v1/SAT/CIEC/fiscal-status-certificate',
  {
    rfc: 'XAXX010101000',
    ciec: 'TU_PASSWORD_CIEC'
  },
  {
    headers: {
      'Accept': 'application/json',
      'Authorization': 'Bearer TU_TOKEN'
    }
  }
);

// Decodificar Base64 y guardar el PDF
const pdfBuffer = Buffer.from(response.data.data.fileBase64, 'base64');
fs.writeFileSync('constancia_situacion_fiscal.pdf', pdfBuffer);
console.log('PDF de CSF guardado exitosamente.');
python
import requests
import base64

url = "https://bridge.paladins.mx/api/v1/SAT/CIEC/fiscal-status-certificate"
headers = {
    "Accept": "application/json",
    "Authorization": "Bearer TU_TOKEN"
}
payload = {
    "rfc": "XAXX010101000",
    "ciec": "TU_PASSWORD_CIEC"
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()

if response.status_code == 200:
    pdf_bytes = base64.b64decode(data['data']['fileBase64'])
    with open('CSF.pdf', 'wb') as f:
        f.write(pdf_bytes)
    print("Constancia guardada con éxito.")