Estos endpoints permiten consultar las facturas (CFDIs) emitidas a través de QRwey! con diferentes niveles de agrupación: por integrador (customer), por emisor (RFC) o por comercio.
Todos los endpoints comparten los mismos filtros y devuelven el mismo formato de respuesta paginada.
Devuelve todas las facturas emitidas por todos los comercios del customer autenticado.
GET /v1/qrs/invoices/by-customerHost (DEV):
https://api-dev.qrwey.comHost (PROD):
https://api.qrwey.comAuthorization: Bearer {{access_token}}| Parámetro | Descripción |
|---|---|
folioUuid | Filtrar por UUID fiscal (búsqueda parcial, opcional) |
search | Buscar por RFC o razón social del emisor o receptor (opcional) |
invoiceStatus | Filtrar por estatus: GENERATED, CANCELLED, CANCEL_REQUESTED, CANCEL_IN_PROGRESS, ERROR (opcional) |
page | Número de página (default: 0) |
size | Elementos por página (default: 20) |
sort | Campo y dirección de ordenamiento (ej. createdAt,desc) |
curl -X GET "https://api-dev.qrwey.com/v1/qrs/invoices/by-customer?invoiceStatus=GENERATED&page=0&size=10" \
-H "Authorization: Bearer {{access_token}}"Devuelve las facturas emitidas por los comercios de un emisor (RFC) específico.
GET /v1/qrs/invoices/by-issuer/{issuerId}Authorization: Bearer {{access_token}}| Parámetro | Descripción |
|---|---|
issuerId | ID del emisor (invoice data) |
Los mismos filtros que el endpoint por integrador: folioUuid, search, invoiceStatus, page, size, sort.
curl -X GET "https://api-dev.qrwey.com/v1/qrs/invoices/by-issuer/inv_data_4aca0361cfcd41c097663db44008fbb9?page=0&size=10" \
-H "Authorization: Bearer {{access_token}}"Devuelve las facturas emitidas por un comercio específico.
GET /v1/qrs/invoices/by-merchant/{merchantId}Authorization: Bearer {{access_token}}| Parámetro | Descripción |
|---|---|
merchantId | ID del comercio |
Los mismos filtros que el endpoint por integrador: folioUuid, search, invoiceStatus, page, size, sort.
curl -X GET "https://api-dev.qrwey.com/v1/qrs/invoices/by-merchant/mer_4aca0361cfcd41c097663db44008fbb9?invoiceStatus=GENERATED&page=0&size=10" \
-H "Authorization: Bearer {{access_token}}"Todos los endpoints devuelven el mismo formato paginado con objetos MerchantInvoice:
{
"content": [
{
"folioUuid": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
"invoiceId": "8f3a1c2d-9b4e-4a7f-91d6-2b8e7c5a1f3d",
"issuerTaxId": "FUNK671228PH6",
"issuerLegalName": "KARLA FUENTE NOLASCO",
"receiverTaxId": "EKU9003173C9",
"receiverLegalName": "ESCUELA KEMPER URGATE",
"invoiceDate": "2026-03-19T14:30:00Z",
"subtotal": 1000.00,
"iva": 160.00,
"total": 1160.00,
"invoiceStatus": "GENERATED"
}
],
"totalElements": 25,
"totalPages": 3,
"number": 0,
"size": 10
}| Campo | Descripción |
|---|---|
folioUuid | UUID fiscal del CFDI |
invoiceId | Identificador interno de la factura |
issuerTaxId | RFC del emisor |
issuerLegalName | Razón social del emisor |
receiverTaxId | RFC del receptor (null si la factura no ha sido timbrada) |
receiverLegalName | Razón social del receptor (null si la factura no ha sido timbrada) |
invoiceDate | Fecha de timbrado |
subtotal | Subtotal del CFDI |
iva | IVA calculado |
total | Total del CFDI |
invoiceStatus | Estatus del CFDI: GENERATED, CANCELLED, CANCEL_REQUESTED, CANCEL_IN_PROGRESS, ERROR |
| Código | Motivo |
|---|---|
| 401 | Token inválido o expirado |
| 404 | Emisor no encontrado |
Consulta: Manejo de errores
- Usa los filtros
searchyinvoiceStatuspara localizar facturas rápidamente - El filtro
folioUuidpermite búsqueda parcial, útil para buscar por fragmento del UUID - Usa el campo
invoiceIdpara obtener el detalle completo con el endpoint de Detalle de CFDI
- Obtener detalle completo: Detalle de CFDI
- Cancelar un CFDI: Cancelar CFDI 4.0
- Vuelve al índice: Gestión de Clientes