Generar código QR

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

En QRwey!, generar un código QR significa crear una intención de autofactura asociada a una transacción específica.

Este QR representa una operación fiscal pendiente que:

• Tiene un monto definido
• Tiene una expiración
• Está firmada y protegida
• Puede convertirse en un CFDI timbrado cuando el usuario la confirma

¿Cuándo generar un QR?

Normalmente debes generar un QR cuando:

• Se completa una venta
• Se imprime un ticket
• El cliente solicita factura
• Deseas habilitar autofactura sin capturas manuales

Cada QR debe representar una sola transacción.

Endpoint

POST /api/v1/qrs

Host (DEV):

https://api-dev.qrwey.com

Host (PROD):

https://clients.qrwey.com

Headers requeridos

X-API-Key: TU_API_KEY
Idempotency-Key: <uuid>
Content-Type: application/json

• X-API-Key autentica la solicitud
• Idempotency-Key evita duplicados en reintentos

⚠️ Usa el mismo Idempotency-Key si reintentas la operación.

Request body

El cuerpo de la solicitud describe completamente la transacción fiscal.

Campos principales

Detalle de conceptos (operation_data)

Cada elemento representa un concepto del CFDI:

Ejemplo de request (DEV)

curl -X POST "https://api-dev.qrwey.com/api/v1/qrs"   -H "X-API-Key: TU_API_KEY"   -H "Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000"   -H "Content-Type: application/json"   -d '{
    "store": "PetroStation #45",
    "issuer_rfc": "EKU9003173C9",
    "amount": 133.00,
    "subtotal": 115.08,
    "currency": "MXN",
    "sat_payment_method": "04",
    "expires_at": "2025-11-01T23:59:59Z",
    "operation": "INVOICE",
    "operation_data": [
      {
        "sku": "GAS87",
        "description": "Gasolina Magna",
        "quantity": 5.662,
        "unit_price": 20.325,
        "amount": 115.08,
        "sat_unit_key": "LTR",
        "sat_product_service_key": "15101515",
        "sat_tax_object_key": "02",
        "taxes": [
          {
            "type": "Traslado",
            "tax": "002",
            "factor": "Tasa",
            "rate": "0.160000",
            "taxable_base": 112.0,
            "amount": 17.92
          }
        ]
      }
    ]
  }'

Respuesta

{
  "qr_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
  "qr_url": "https://clients.qrwey.com/qr.png?...",
  "qr_content": "https://clients.qrwey.com/go?v=1&t=...&m=...",
  "created_at": "2025-09-11T18:25:43Z",
  "expires_at": "2025-11-01T23:59:59Z"
}

¿Qué debes guardar?

• qr_content: valor principal
• expires_at: control de vigencia
• qr_url o qr_base64: para mostrar o imprimir

Errores comunes

Consulta: Manejo de errores

Buenas prácticas

• Genera el QR una sola vez por venta
• Define expiraciones realistas conforme a las reglas del negocio (ej. 5 días, hasta fin de mes, etc.)
• Maneja explícitamente errores 409 y 410

¿Qué sigue?

• Resolver un QR: Resolver código QR
• Entender estados: Ciclo de vida del QR
• Detalle completo: Referencia del API