Saltar al contenido principal
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ónExtractor
Declaraciones anualesannual_tax_return
Declaraciones provisionales mensualesmonthly_tax_return
Declaraciones de RIFrif_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 entidadValores soportados de productTypePredeterminado
Persona007, 004, INFORME_BURO007
EmpresaINFORME_BURO, RCOINFORME_BURO