Get your Agencia Virtual SAT documents through an API

What you can build on the Agencia Virtual

• Get tax documents for a period

  Build this

  Reads Visualizar Documentos Tributarios in Planilla IVA-FEL for a date range, filtered by Tipo Documento (FEL, papel, Formularios DG, DUCA) or NIT Emisor.

  Takes

  Period from, period to, document type (optional), issuer NIT (optional)

  Returns

  Supplier NIT, supplier name, document date, document type, series, document number, authorization number, total, IVA, included

• Get IVA Crédito totals

  Build this

  Reads the Montos Ingresados panel of Planilla IVA-FEL: IVA Crédito and document total for FEL, PAPEL, DUCA, FORMULARIOS DG and the overall TOTAL.

  Takes

  Nothing

  Returns

  Source, IVA crédito, document total, overall IVA crédito, overall total

• List filed planillas for a year

  Build this

  Reads the Planillas Presentadas table in Planilla IVA-FEL and keeps the planillas presented in the year you give, with their totals and the Última presentada mark.

  Takes

  Year

  Returns

  Planilla number, filed at, last filed, employer NIT, employer name, total subject to IVA, total IVA

• Present the Planilla IVA-FEL

  Build this

  Selects Presentar Planilla in Planilla IVA-FEL, which generates Formulario SAT-1111 and the Constancia de Recepción, and reads the new filing.

  Takes

  Nothing

  Returns

  Planilla number, filed at, employer NIT, total purchases, total IVA, reference number

Automate the Agencia Virtual with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• New Documentos Tributarios, checked on the 5th

  Build this

  Starts

  Monthly on the 5th at 8:00, America/Guatemala

  Step 1

  Get the tax documents dated from 1 January of this year to today.

  Step 2

  Keep the documents that were not there on the last run.

  Step 3

  Email you the list with supplier, document type, series, number, total and IVA.

• IVA Crédito totals, emailed when they change

  Build this

  Starts

  Every weekday at 8:00, America/Guatemala

  Step 1

  Get the IVA Crédito totals from Montos Ingresados.

  Step 2

  Keep the run only when a total changed since the last run.

  Step 3

  Email you IVA Crédito and total for FEL, PAPEL, DUCA, FORMULARIOS DG and TOTAL.

• Last filed planilla, sent to payroll

  Build this

  Starts

  When your payroll system calls the workflow's webhook with a year

  Step 1

  List the Planillas Presentadas for that year.

  Step 2

  Keep the row marked SI in Última presentada.

  Step 3

  Post its number, filing date, NIT Patrono, Total Afecto IVA and Total IVA to your payroll webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get tax documents for a period” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "farm3.sat.gob.gt/get_tax_documents",
    "input": {
      "period_from": "2026-10-01",
      "period_to": "2026-10-31",
      "document_type": "FEL"
    }
  }'

{
  "status": "completed",
  "data": {
    "period_from": "2026-10-01",
    "period_to": "2026-10-31",
    "documents": [
      {
        "supplier_nit": "4821736",
        "supplier_name": "Acme, S.A.",
        "document_date": "2026-10-07",
        "document_type": "FACT",
        "series": "7C2E91A4",
        "document_number": "2215580931",
        "authorization_number": "7C2E91A4-83F1-4D2B-9A6E-0F5B12C47D88",
        "total_purchases": 448,
        "iva": 48,
        "included": true
      }
    ],
    "count": 1,
    "currency": "GTQ"
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

The Agencia Virtual’s own options

SAT's user manuals for the Agencia Virtual describe no API or data export for taxpayers. You sign in and work on screen: Planilla IVA-FEL shows your Documentos Tributarios and generates Formulario SAT-1111 with a Constancia de Recepción, and returns are prepared in Declaraguate. Business software issues FEL invoices through a third-party certifier.

Read on November 12, 2026: SAT, Planilla IVA-FEL: Manual para Usuarios Externos (December 2022), SAT, Manual para la generación de usuario de SAT en línea, Odoo, Guatemala fiscal localization (FEL through a certifier).

Signing in to the Agencia Virtual

The Agencia Virtual asks for your Usuario, which is your NIT, and your Contraseña. A collaborator signing in for a taxpayer ticks Permisos delegados. With Fous you sign in once through the Agencia Virtual's own sign-in with your own account: the login is sealed with AES-256, and an expired session is signed back in.

Worth knowing

Presentar Planilla opens only in January

Planilla IVA-FEL is for taxpayers affiliated to the Régimen Asalariado. Presentar Planilla is available from 1 January and is switched off on the tenth business day of January at 12:00 am.

The last planilla presented counts

You can include or exclude a document and present the planilla again within the 10 business days set by Article 72 of Decreto 10-2012. The last Planilla IVA-FEL presented is the one to report to your employer.

Paper documents cannot be annulled

A paper document saved in error cannot be annulled: you set it to Excluir so the planilla leaves it out. Paper entry covers pre-printed documents valid until 30 June 2022.

The user is personal

An Agencia Virtual user is activated only after the taxpayer signs the printed request at a SAT office or agency. The form states that the user and password are not transferable.

More in Government: Latin America

• Mis Comprobantes
• Facturación Electrónica DIAN
• Simplificación Registral
• ARCA - servicios con Clave Fiscal
• Portal Empresarial INFONAVIT
• SIFERE Web
• Declaración en Línea (F.931)
• AFPnet
• ARBA
• SEACE
• SECOP II
• BPS Servicios en Línea
• IESS - Portal de Empleadores
• Oficina Virtual CCSS (SICERE)
• SUIR
• Previred
• Aportes en Línea
• SOI
• SIPARE
• DGI Servicios en Línea
• e-Tax 2.0
• Oficina Virtual DGII
• Portal del SAT (Factura Electrónica)
• SII (Mi SII)
• SRI en Línea
• SUNAT Operaciones en Línea (SOL)
• TRIBU-CR
• Declaraciones y Pagos (SAT)
• DIAN MUISCA

Other industries: ICP Smart Services, e-Beyanname, MOT Testing Service, eFileIL, RP Data Professional, COD.