API de Magifactura

curl https://magifactura.com/api/v1/me \
  -H "Authorization: Bearer $MAGIFACTURA_API_KEY"

curl https://magifactura.com/api/v1/facturas \
  -H "Authorization: Bearer $MAGIFACTURA_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-1042" \
  -d '{
  "receptor": {
    "rfc": "EKU9003173C9",
    "nombre": "ESCUELA KEMPER URGATE",
    "cp": "42501",
    "regimen": "601",
    "usoCfdi": "G03"
  },
  "conceptos": [
    {
      "descripcion": "Consultoría",
      "claveProdServ": "80111600",
      "precio": 1000
    }
  ],
  "formaPago": "03"
}'

// Node 18+ con ES modules (archivo .mjs)
const res = await fetch('https://magifactura.com/api/v1/facturas', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.MAGIFACTURA_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'pedido-1043'
  },
  body: JSON.stringify({
    "receptor": {
      "rfc": "EKU9003173C9",
      "nombre": "ESCUELA KEMPER URGATE",
      "cp": "42501",
      "regimen": "601",
      "usoCfdi": "G03"
    },
    "conceptos": [
      {
        "descripcion": "Consultoría",
        "claveProdServ": "80111600",
        "precio": 1000
      }
    ],
    "formaPago": "03"
  })
});
const factura = await res.json();
console.log(factura.uuid, factura.pdfUrl);

import os, requests

res = requests.post(
    "https://magifactura.com/api/v1/facturas",
    headers={
        "Authorization": f"Bearer {os.environ['MAGIFACTURA_API_KEY']}",
        "Idempotency-Key": "pedido-1044",
    },
    json={
        "receptor": {
            "rfc": "EKU9003173C9",
            "nombre": "ESCUELA KEMPER URGATE",
            "cp": "42501",
            "regimen": "601",
            "usoCfdi": "G03"
        },
        "conceptos": [
            {
                "descripcion": "Consultoría",
                "claveProdServ": "80111600",
                "precio": 1000
            }
        ],
        "formaPago": "03"
    },
)
factura = res.json()
print(factura["uuid"], factura["pdfUrl"])

{
  "id": "3f2b8c1e-5d0a-4c7e-9b1a-2e6f0c9d4a71",
  "uuid": "7A1C0F55-9B44-4E1E-9A55-0D2B5C9E1F01",
  "status": "timbrada",
  "modo": "test",
  "serie": null,
  "folio": null,
  "fecha": "2026-10-04T18:00:00.000Z",
  "receptor": {
    "clienteId": "9d1b7c2a-4e5f-4a6b-8c7d-0e1f2a3b4c5d",
    "rfc": "EKU9003173C9",
    "nombre": "ESCUELA KEMPER URGATE",
    "usoCfdi": "G03"
  },
  "formaPago": "03",
  "metodoPago": "PUE",
  "moneda": "MXN",
  "subtotal": 1000,
  "descuento": 0,
  "total": 1160,
  "error": null,
  "xmlUrl": "https://magifactura.com/api/v1/facturas/3f2b8c1e-5d0a-4c7e-9b1a-2e6f0c9d4a71/xml",
  "pdfUrl": "https://magifactura.com/api/v1/facturas/3f2b8c1e-5d0a-4c7e-9b1a-2e6f0c9d4a71/pdf",
  "conceptos": [
    {
      "descripcion": "Consultoría",
      "claveProdServ": "80111600",
      "claveUnidad": "E48",
      "cantidad": 1,
      "precio": 1000,
      "descuento": 0,
      "tasaIva": "16"
    }
  ],
  "cancelacion": null
}

{
  "conceptos": [
    {
      "descripcion": "Café americano",
      "cantidad": 2,
      "precio": 45
    },
    {
      "descripcion": "Pan dulce",
      "precio": 30
    }
  ],
  "formaPago": "01",
  "folio": "T-1042"
}

{
  "error": {
    "code": "validacion",
    "message": "receptor.rfc: RFC inválido (12 o 13 caracteres, p. ej. EKU9003173C9)",
    "field": "receptor.rfc"
  }
}

claude mcp add --transport http magifactura https://magifactura.com/api/mcp \
  --header "Authorization: Bearer $MAGIFACTURA_API_KEY"