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.

​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

SAT