Ejemplos de solicitudes de extracción

Usa estos ejemplos al crear extracciones a través de la API. Cada solicitud utiliza una IRI de entidad y un nombre de extractor. Algunos extractores también aceptan opciones que controlan el periodo, la dirección, los tipos de archivo o el producto del proveedor. Para detalles del endpoint, consulta Crear una extracción.

SAT

Facturas

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "invoice",
  "options": {
    "period": {
      "from": "2024-01-01",
      "to": "2024-12-31"
    },
    "issued": true,
    "received": true,
    "xml": true,
    "pdf": true
  }
}

Los pagos de facturas, pagos en lote, conceptos, relaciones y notas de crédito se derivan de los datos de CFDI de las facturas. Incluye facturas tipo P para registros de pago y facturas tipo E para notas de crédito al seleccionar los tipos de factura.

Retenciones de impuestos

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "tax_retention",
  "options": {
    "period": {
      "from": "2024-01-01",
      "to": "2024-12-31"
    },
    "issued": true,
    "received": true,
    "xml": true,
    "pdf": true
  }
}

Declaraciones de impuestos

Usa el extractor para el tipo de declaración que necesites.

Datos de declaración	Extractor
Declaraciones anuales	`annual_tax_return`
Declaraciones provisionales mensuales	`monthly_tax_return`
Declaraciones de RIF	`rif_tax_return`

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "annual_tax_return",
  "options": {
    "period": {
      "from": "2020-01-01",
      "to": "2024-12-31"
    }
  }
}

Usa monthly_tax_return o rif_tax_return con la misma forma de solicitud cuando necesites esos tipos de declaración.

Situación fiscal

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "tax_status"
}

Verificación de cumplimiento fiscal

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "tax_compliance"
}

Contabilidad electrónica

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "electronic_accounting",
  "options": {
    "period": {
      "from": "2023-01-01",
      "to": "2024-12-31"
    }
  }
}

Certificados del SAT

{
  "entity": "/entities/7b3a25a9-a53a-4846-abe6-f2574c9c2d5d",
  "extractor": "sat_certificates"
}

RPC

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "rpc"
}

El extractor rpc crea entidades, actos y socios del RPC cuando el registro devuelve datos coincidentes.

RUG

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "rug"
}

El extractor rug crea garantías y operaciones del RUG cuando el registro devuelve datos coincidentes.

BIL

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "bil"
}

Buró de Crédito

La entidad debe tener datos de contribuyente y una autorización válida de Buró de Crédito antes de que la extracción pueda ejecutarse.

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "buro_de_credito_report",
  "options": {
    "productType": "007"
  }
}

La opción productType controla qué producto de Buró de Crédito se solicita.

Tipo de entidad	Valores soportados de `productType`	Predeterminado
Persona	`007`, `004`, `INFORME_BURO`	`007`
Empresa	`INFORME_BURO`, `RCO`	`INFORME_BURO`

Verificación de antecedentes

Ejecuta una verificación de antecedentes para una entidad. El extractor background_check puede usarse en extracciones puntuales y en reglas de planificadores recurrentes para mantener actualizados los resultados de las entidades monitoreadas.

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "background_check"
}

Para los registros y el reporte PDF resultantes, consulta Verificación de antecedentes.

Infonavit

Verifica si el registro patronal de una entidad aparece en la lista Créditos Firmes de Infonavit de obligaciones de crédito de vivienda firmes (vencidas). El extractor infonavit coteja por el nombre de la entidad, por lo que no se requieren credenciales del SAT.

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "infonavit",
  "options": {}
}

El extractor infonavit no acepta ninguna opción. Envía un objeto options vacío u omite el campo por completo. Si la entidad no aparece en la lista, la extracción termina exitosamente y no devuelve registros. Para los registros resultantes, consulta Créditos firmes de Infonavit.

Comienza aquí

Guías de integración

Ejemplos de solicitudes de extracción

SAT

Facturas

Retenciones de impuestos

Declaraciones de impuestos

Situación fiscal

Verificación de cumplimiento fiscal

Contabilidad electrónica

Certificados del SAT

RPC

RUG

BIL

Buró de Crédito

Verificación de antecedentes

Infonavit

​SAT

​Facturas

​Retenciones de impuestos

​Declaraciones de impuestos

​Situación fiscal

​Verificación de cumplimiento fiscal

​Contabilidad electrónica

​Certificados del SAT

​RPC

​RUG

​BIL

​Buró de Crédito

​Verificación de antecedentes

​Infonavit

SAT

Facturas

Retenciones de impuestos

Declaraciones de impuestos

Situación fiscal

Verificación de cumplimiento fiscal

Contabilidad electrónica

Certificados del SAT

RPC

RUG

BIL

Buró de Crédito

Verificación de antecedentes

Infonavit