Postman Collection

3 formas de importar

https://www.postman.com/import/import-from-url?url=https://api.cfdi4.com/docs/postman-spec

Configurar tu API key (1 sola vez)

1. 1

   Abre el Environment

   Click en el icono de engranaje → Manage Environments → Create new environment llamado "SAT API".

2. 2

   Anade una variable

   Variable: api_key, valor actual: sat_xxxxxxxxxxxx (tu API key real).

3. 3

   Guarda y selecciona el environment

   Esquina superior derecha de Postman, selecciona "SAT API" en el dropdown de environments.

4. 4

   Listo, prueba

   Cualquier endpoint ahora usa {{api_key}} automaticamente. Click Send y deberias ver una respuesta JSON.

Probar tu primera llamada

Recomendamos empezar con /api/v1/usuario/datos-fiscales.

1. Click en SAT API → usuario → datos-fiscales
2. Tab Authorization → tipo Bearer Token → pega {{api_key}}
3. Tab Headers → anade User-Agent: MiApp/1.0
4. Tab Body → raw → JSON:

{
  "rfc": "XAXX010101000"
}

Click Send. Veras una respuesta JSON con cfdi_codigo: 1.

Automatizar pruebas (bonus)

Postman puede correr tests automaticos. Agrega este script a la tab Tests:

pm.test("Status 200", function () {
    pm.response.to.have.status(200);
});
pm.test("cfdi_codigo = 1 (exito)", function () {
    var json = pm.response.json();
    pm.expect(json.cfdi_codigo).to.eql(1);
});
pm.test("Saldo decrementado", function () {
    var json = pm.response.json();
    pm.expect(json.saldo).to.be.a("number");
});

Problemas comunes