{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Monthly declarations","version":"0.1.0","summary":"Compute, save and file SAT's monthly declarations with the form's own rules, obligation by obligation.","description":"This API computes and files the monthly declarations of a taxpayer with SAT (*pagos provisionales y definitivos*). It uses the rules of SAT's own form, so its totals are SAT's.\n\n## Getting started\n\nSAT SDK is in early access, and we'd love to have you in. Drop us a line at [contacto@satsdk.com](mailto:contacto@satsdk.com) and tell us what you're building. We'll get you an API key and walk you through your first declaration. A sandbox is on the way. Things here will still move a bit while we build, and you'll hear it from us first.\n\nOnce you have the key, send it as a bearer token in `Authorization` on every request. Anything that reaches SAT also needs the taxpayer's session in `Sat-Session`. More on that under [Sessions](#tag/sessions). Errors come back as problem details (RFC 9457), the same `Problem` on every request, and a failed task carries it in `problem`.\n\nYou don't have to run the whole flow every time:\n\n- Just want the amount to pay, with nothing saved in SAT? Steps 1 to 3.\n- The taxpayer wants to review before filing? The whole flow.\n- Already have the decisions and just want it filed? [File a declaration](#tag/filings/fileDeclaration), in one request.\n\n## Flow\n\n1. [Sign in](#tag/sessions) with the e.firma or the CIEC of the taxpayer. Send the session ID in `Sat-Session` on each request that reaches SAT.\n2. [Load the prefill](#tag/prefills/loadPrefill) of the period. Not sure which obligations to list? The [period options](#tag/periods/loadPeriodOptions) tell you what the period can file.\n3. [Compute the draft](#tag/drafts/computeDraft) as often as necessary. It does not reach SAT.\n4. [Save the draft](#tag/drafts/saveDraft) with the same decisions. SAT checks it.\n5. [File the draft](#tag/filings/fileDraft) with its `draftSnapshot` and the `expectedAmountToPay` that the taxpayer approved.\n\nTo file without a review, [file a declaration](#tag/filings/fileDeclaration) with the decisions and `expectedAmountToPay`. One task loads the prefill, computes the declaration, saves it and files it. Only the amount protects this filing.\n\nEach request that reaches SAT returns `202` and a [task](#tag/tasks). When SAT answers, the task links to what it brought back, which a `GET` reads."},"servers":[{"url":"https://api.satsdk.com/v1","description":"Production"}],"security":[{"bearer":[]}],"tags":[{"name":"Sessions","description":"Requests that reach SAT run in the taxpayer's SAT session. A taxpayer has one open session per account, closed after 15 idle minutes. Sign in with either:\n\n- e.firma: get a challenge, sign it where the e.firma is, and send the certificate and the signature. The e.firma never reaches the API.\n- CIEC: send the RFC and the password. The API uses it for that login only and does not keep it.\n\nSAT blocks repeated logins. After a refused one, the API refuses the RFC's sign-ins for 30 minutes. Do not sign in to SAT elsewhere while a session is open.\n\nWhen SAT logs a session in or refuses it, and when it closes, the API posts an event named after its new status, such as `session.active`. Events are delivered and signed as [Tasks](#tag/tasks) says."},{"name":"Periods","description":"What SAT offers for a month, before anything is loaded. The [options](#tag/periods/loadPeriodOptions) list every obligation that the form of the period can file, whether the taxpayer is registered for it and whether SAT has it filed, and whether SAT offers a complementaria. Read them to know which obligations to list when you [load the prefill](#tag/prefills/loadPrefill)."},{"name":"Prefills","description":"What SAT preloaded for the obligations of a month as of today: the declaration with nothing answered yet, which shows SAT's values and what the form still needs. [Load it](#tag/prefills/loadPrefill) for the obligations to declare. Its `prefillSnapshot` names it: [read it](#tag/prefills/getPrefill) with it, and send it when you compute and save the draft."},{"name":"Drafts","description":"The draft that SAT holds for the period: a declaration saved on SAT's portal and not filed, one per period and type. Compute it on the prefill as often as necessary without SAT. Then save it, so that SAT checks it, and [file it](#tag/filings/fileDraft). Its `draftSnapshot` names it. If loading the prefill fails with `existing_draft`, [query the draft](#tag/drafts/queryDraft). If it was saved today, you can file it. Otherwise, [delete it](#tag/drafts/deleteDraft) and load the prefill again.\n\n## Obligations\n\n`declaration.obligations` lists the obligations that a declaration files. A registered obligation that it does not list is not filed. If a listed obligation has no block, the request answers none of its questions. To file an obligation on zeros, send `false` for its questions and 0 for each amount that the form needs. A declaration can list these obligations:\n\n- `isr.resicoIndividual`: ISR simplificado de confianza. Personas físicas (0168).\n- `isr.business`: ISR personas físicas. Actividad empresarial y profesional (0161).\n- `isr.companies`: ISR personas morales (0164).\n- `isr.salaryWithholdings`: ISR retenciones por salarios (0112).\n- `isr.assimilatedWithholdings`: ISR retenciones por asimilados a salarios (0113).\n- `iva.resico`: IVA simplificado de confianza (0318).\n- `iva.general`: Impuesto al Valor Agregado. Personas morales or Impuesto al Valor Agregado. Personas físicas (0301).\n\n## Values\n\nAmounts are integers in whole pesos (MXN). `0` declares zero. Null means the same as an omitted value. This spec calls both \"left out\".\n\nA value behind one of the form's questions answers it. `false` answers *No*, and a value answers *Sí*. Behind a question, an empty value (`0`, `[]`, `{}`) fails with `invalid_request`. An answer shows `declared: false` for *No*.\n\n- If SAT preloaded an editable value other than 0, or SAT's form suggests one, send it, even to keep it. SAT's form suggests *actualización*, *recargos* and the first payment of installments. If it is left out, compute keeps SAT's value in the figures and returns a `missing_value` issue with that value in `sat`.\n- If a request sends a breakdown, or SAT preloaded or suggests one of its parts, a part that the taxpayer can type is 0 when left out.\n- If the form computes a value or does not let it change, left out keeps the form's value. Never send a read-only value, marked `editable: false` in the prefill.\n- A question stays unanswered when its value is left out. So does a value with fixed options.\n- Anything else that is left out declares nothing. If the form needs it, compute returns a `missing_value` issue. Otherwise, an amount is 0 and a list adds no rows.\n\nAmounts by concept take only the concepts that SAT's form offers in the declaration, which an answer lists in `options`. SAT can offer fewer than this spec lists, for example in the border region (*región fronteriza*).\n\n## What SAT has behind a value\n\nThese parts of a declaration are output only. A request never sends them.\n\n`invoices` is SAT's *detalle* of the invoices behind a value: how many invoices SAT counted and what they add up to. It never lists single invoices. If a detail's base, IVA or tax withheld is not 0, it shows. SAT counts the same invoices in the detail of each rate. If a detail has none of these figures, it shows when any of its figures is not 0.\n\n`earlierPeriods` lists what SAT has of the earlier months of the year, one row per month. For a persona moral, these are the earlier declarations, with their status and filing date. `payment.identifiedPayments` lists the payments that SAT identified for the period. `payment.unmatchedPaymentOptions` lists the payments that `payment.unmatchedPayments` can take.\n\nIf one of its rows holds something, a list shows. The immediate deductions show only if one is not 0. The earlier income of RESICO shows only if it holds income from agriculture, livestock, forestry or fishing, or from selling fixed assets."},{"name":"Filings","description":"The declarations that you file. [Filing the draft](#tag/filings/fileDraft) or [a declaration](#tag/filings/fileDeclaration) brings back the `Filing`, as SAT acknowledged it in the acuse: its operation number, its period and obligations, and its payment reference with the amount to pay. [Read it](#tag/filings/getFiling) by its operation number for 48 hours. What SAT has on record after that, such as its payment, is a [filing query](#tag/filing-queries), which answers each filing in the same `Filing` shape.\n\n## Filing date\n\nSAT computes each declaration as of the day that its prefill was loaded, in Mexico City time. Compute, save and file on that day. On a later day, these steps fail, so load the prefill again. If the declaration is late, the new prefill can owe more, because *actualización* and *recargos* change every day."},{"name":"Filing queries","description":"What SAT has on record as filed, read from SAT on request: the declarations filed through this API, on SAT's portal or anywhere else. A [query](#tag/filing-queries/queryFilings) asks for the filings of a year, or of one month of it. Its answer is what SAT had on record when it answered, each filing a `Filing`, as filing returns it: whether it is in effect or a complementaria replaced it, its payment reference, and whether SAT identified its payment. To know what SAT has now, query again. Each filing has PDFs to [read](#tag/filing-queries/requestFilingDocument): the declaration, the acuse and the payment."},{"name":"Tasks","description":"Each request that reaches SAT returns `202` with a task. SAT takes about a minute, sometimes a few. The task says where SAT's work is. When it completes, its `resource` links to what it brought back, such as the `Prefill`, which a `GET` reads without reaching SAT. When it fails, its `problem` says why. A session runs its tasks one at a time, in the order that they came. If the same read is already waiting or with SAT, the request returns that task. What a task brought back is kept for 48 hours, longer than the API retries an event.\n\n## Webhooks\n\nWhen a task completes or fails, the API posts an event named after its `action` and how it ended, such as `prefill.completed` or `prefill.failed`. The event carries the task without its `problem`: read what it brought back at `data.resource.url`, or its `problem` with `GET /tasks/{id}`. Without a webhook endpoint, poll the task every few seconds. Each operation's events are listed in its own section, next to it, and a session's, such as `session.active`, in [Sessions](#tag/sessions).\n\nThe dashboard holds your endpoint and its secret. To make sure that an event is ours, per [Standard Webhooks](https://github.com/standard-webhooks/standard-webhooks/blob/main/spec/standard-webhooks.md):\n\n1. Base64-decode the secret after `whsec_`.\n2. With it, compute the base64 HMAC-SHA256 of `{webhook-id}.{webhook-timestamp}.{raw body}`.\n3. Compare it in constant time with each `v1` signature in `webhook-signature`.\n4. Reject a `webhook-timestamp` over 5 minutes from your clock.\n\nWithout a 2xx in 15 seconds, the API retries with exponential backoff for 24 hours. Events can repeat and arrive out of order."},{"name":"Glossary","description":"SAT's terms that this reference uses, and what each one means.\n\n- Invoice: a CFDI, the electronic invoice that SAT registers. SAT preloads most totals from the invoices of the taxpayer.\n- Prefill (*precarga*): the values that SAT preloads for the period.\n- Obligation (*obligación*): a tax that the taxpayer is registered to declare. A declaration files the obligations that it lists.\n- RFC: the tax ID of the taxpayer.\n- e.firma: the certificate and key of the taxpayer for SAT.\n- CIEC: the password of the taxpayer for SAT (*contraseña*).\n- RESICO: a simplified tax regime (*Régimen Simplificado de Confianza*).\n- Persona física, persona moral: an individual, a company.\n- Payment reference (*línea de captura*): the reference that the taxpayer pays at a bank.\n- Draft (*declaración temporal*): a declaration saved on SAT's portal and not filed.\n- Acuse: the receipt that SAT gives for a filed declaration.\n- Complementaria: a declaration that amends one already filed.\n- Actualización, recargos: the inflation adjustment and the surcharges on late tax."}],"paths":{"/sessions/challenges":{"post":{"operationId":"createChallenge","tags":["Sessions"],"summary":"Get an e.firma challenge","description":"Opens SAT's e.firma login and returns its challenge, for the e.firma of the taxpayer to sign. It is not a login, so nothing counts against the taxpayer. The challenge expires after 15 minutes.","responses":{"201":{"description":"The challenge.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Challenge"},"examples":{"challenge":{"summary":"The challenge to sign","value":{"id":"chl_01JA6X6V2W4Y6Z8B","value":"7f3c1a9e-2b4d-4e8f-9a6c-5d1e3b7a9c2f","createdAt":"2026-10-14T08:59:20-06:00","expiresAt":"2026-10-14T09:14:20-06:00"}}}}}},"503":{"description":"SAT did not respond, or it responded with an error. Retry later.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sat_unavailable"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"satUnavailable":{"summary":"SAT's login is down","value":{"type":"https://api.satsdk.com/problems/sat_unavailable","title":"SAT unavailable","status":503,"detail":"The SAT login did not respond. Retry later.","errors":[{"code":"sat_unavailable","message":"The SAT login did not respond. Retry later."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/sessions/efirma":{"post":{"operationId":"signInWithEfirma","tags":["Sessions"],"summary":"Sign in with the e.firma","description":"Logs in to SAT with the e.firma signature of a challenge, and returns the session at once. The session is `signing_in` for about a minute, then `active` or `rejected`. If the taxpayer already has an open session, it returns that session and does not log in. A refused login counts against the taxpayer, and the API never retries it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EfirmaSignInRequest"},"examples":{"signed":{"summary":"The challenge, signed","value":{"challenge":"chl_01JA6X6V2W4Y6Z8B","certificate":"MIIGJzCCBA+gAwIBAgIUMDAwMDEwMDAwMDA3MDAwMDAwMDAwDQYJKoZIhvcNAQELBQAw","signature":"kQ3vP8yXc2Lr0eT5uWbJ9nA4mZs7HdF1gKqC6oVwYiR2tE8xU3pN0jMlB5aS9fGh"}}}}}},"responses":{"200":{"description":"The taxpayer's open session. No login was sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"open":{"summary":"Active after the filing","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"active","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":"2026-10-14T09:46:44-06:00","endedAt":null,"metadata":{}}}}}}},"202":{"description":"Signing in. The session changes to `active` or `rejected` when SAT finishes the login.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"signingIn":{"summary":"SAT is logging in with the e.firma","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"signing_in","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":null,"metadata":{}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"409":{"description":"The challenge expired or was used, or SAT refused a login for the RFC in the last 30 minutes.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["challenge_expired","sign_in_cooldown"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"expired":{"summary":"Signed after 15 minutes","value":{"type":"https://api.satsdk.com/problems/challenge_expired","title":"Challenge expired","status":409,"detail":"Challenge chl_01JA6X6V2W4Y6Z8B expired at 2026-10-14T09:14:20-06:00. Get a new one.","errors":[{"code":"challenge_expired","message":"Challenge chl_01JA6X6V2W4Y6Z8B expired at 2026-10-14T09:14:20-06:00. Get a new one."}]}},"coolingDown":{"summary":"A refused login 10 minutes ago","value":{"type":"https://api.satsdk.com/problems/sign_in_cooldown","title":"Sign-in cooling down","status":409,"detail":"SAT refused a login for XAXX010101000 at 2026-10-14T09:00:31-06:00. Sign-ins are refused until 2026-10-14T09:30:31-06:00.","errors":[{"code":"sign_in_cooldown","message":"SAT refused a login for XAXX010101000 at 2026-10-14T09:00:31-06:00. Sign-ins are refused until 2026-10-14T09:30:31-06:00."}]}}}}}},"422":{"description":"The certificate is not a valid e.firma, or the signature is not a signature of the challenge. Nothing was sent to SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_signature"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notSigned":{"summary":"A signature of another challenge","value":{"type":"https://api.satsdk.com/problems/invalid_signature","title":"Invalid signature","status":422,"detail":"The signature is not of challenge chl_01JA6X6V2W4Y6Z8B.","errors":[{"code":"invalid_signature","path":"signature","message":"The signature is not of challenge chl_01JA6X6V2W4Y6Z8B."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/sessions/ciec":{"post":{"operationId":"signInWithCiec","tags":["Sessions"],"summary":"Sign in with the CIEC","description":"Logs in to SAT with the RFC and CIEC of the taxpayer, and returns the session at once. The session is `signing_in` for a few seconds, then `active` or `rejected`. If the taxpayer already has an open session, it returns that session and does not log in. A refused login counts against the taxpayer, and the API never retries it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CiecSignInRequest"},"examples":{"ciec":{"summary":"The RFC and CIEC","value":{"rfc":"XAXX010101000","password":"Contrasena2026"}}}}}},"responses":{"200":{"description":"The taxpayer's open session. No login was sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"open":{"summary":"Active after the filing","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"active","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":"2026-10-14T09:46:44-06:00","endedAt":null,"metadata":{}}}}}}},"202":{"description":"Signing in. The session changes to `active` or `rejected` when SAT finishes the login.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"signingIn":{"summary":"SAT is logging in with the CIEC","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"ciec","status":"signing_in","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":null,"metadata":{}}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"409":{"description":"SAT refused a login for the RFC in the last 30 minutes. Another refused login can lock the taxpayer out of SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_cooldown"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"coolingDown":{"summary":"A refused login 10 minutes ago","value":{"type":"https://api.satsdk.com/problems/sign_in_cooldown","title":"Sign-in cooling down","status":409,"detail":"SAT refused a login for XAXX010101000 at 2026-10-14T09:00:31-06:00. Sign-ins are refused until 2026-10-14T09:30:31-06:00.","errors":[{"code":"sign_in_cooldown","message":"SAT refused a login for XAXX010101000 at 2026-10-14T09:00:31-06:00. Sign-ins are refused until 2026-10-14T09:30:31-06:00."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/sessions/{id}":{"parameters":[{"$ref":"#/components/parameters/SessionId"}],"get":{"operationId":"getSession","tags":["Sessions"],"summary":"Retrieve a session","description":"Returns the session and its status. With a webhook endpoint you hear back without asking.","responses":{"200":{"description":"The session.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"signingIn":{"summary":"SAT is logging in with the e.firma","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"signing_in","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":null,"metadata":{}}},"signedIn":{"summary":"Signed in","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"active","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":"2026-10-14T09:15:48-06:00","endedAt":null,"metadata":{}}},"active":{"summary":"Active after the filing","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"active","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":"2026-10-14T09:46:44-06:00","endedAt":null,"metadata":{}}},"rejected":{"summary":"SAT refused the login","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"rejected","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":"2026-10-14T09:00:31-06:00","metadata":{}}},"idle":{"summary":"Closed after 15 minutes without a task","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"closed","closedReason":"idle","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":null,"endedAt":"2026-10-14T09:46:44-06:00","metadata":{}}},"signedOut":{"summary":"SAT ended the session","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"closed","closedReason":"signed_out","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":null,"endedAt":"2026-10-14T09:20:37-06:00","metadata":{}}},"captchaFailed":{"summary":"SAT's captcha was not answered","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"ciec","status":"closed","closedReason":"captcha_failed","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":"2026-10-14T08:59:58-06:00","metadata":{}}}}}}},"404":{"$ref":"#/components/responses/SessionNotFound"},"default":{"$ref":"#/components/responses/Problem"}}},"delete":{"operationId":"closeSession","tags":["Sessions"],"summary":"Close the session","description":"Logs the session out of SAT, after the task running in it, if any. Tasks still queued on it fail with `session_closed`. Closing a closed session returns it as it is.","responses":{"200":{"description":"The session, closed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Session"},"examples":{"closed":{"summary":"Closed by you","value":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"closed","closedReason":"requested","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":null,"endedAt":"2026-10-14T09:32:05-06:00","metadata":{}}}}}}},"404":{"$ref":"#/components/responses/SessionNotFound"},"default":{"$ref":"#/components/responses/Problem"}}}},"/period-options":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"loadPeriodOptions","tags":["Periods"],"summary":"Read the period options","description":"Asks SAT what it offers for the period: every obligation that the form can file, and the types of declaration. Use it to know which obligations to list before you load the prefill. It changes nothing in SAT. The task brings back the `PeriodOptions`. If SAT offers no declaration for the period, the task fails with `not_offered`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodOptionsRequest"},"examples":{"september":{"summary":"September","value":{"period":"2026-09"}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `PeriodOptions`: read it with [`GET /period-options/{id}`](#tag/periods/getPeriodOptions).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA6Y0R5T7W9Y2B"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"period_options","description":"Always `period_options`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","not_offered"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"queued":{"summary":"Waiting for the session to sign in","value":{"id":"tsk_01JA6Y0R5T7W9Y2B","action":"period_options","status":"queued","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":null,"completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/period-options/{id}":{"parameters":[{"$ref":"#/components/parameters/PeriodOptionsId"}],"get":{"operationId":"getPeriodOptions","tags":["Periods"],"summary":"Retrieve period options","description":"Returns the period options that a task brought back. It does not reach SAT. The API keeps them for 48 hours.","responses":{"200":{"description":"The `PeriodOptions`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PeriodOptions"},"examples":{"september":{"summary":"September's options: ISR and IVA registered, nothing filed yet","value":{"id":"pop_01JA6Y0S6V8X1Z3C","period":"2026-09","normal":true,"complementaria":{"modification":false,"withoutEffect":false,"notFiled":false},"obligations":[{"code":"0168","name":"ISR simplificado de confianza. Personas físicas","path":"isr.resicoIndividual","supported":true,"registered":true,"filed":false,"modifiable":false},{"code":"0112","name":"ISR retenciones por salarios","path":"isr.salaryWithholdings","supported":true,"registered":false,"filed":false,"modifiable":false},{"code":"0113","name":"ISR retenciones por asimilados a salarios","path":"isr.assimilatedWithholdings","supported":true,"registered":false,"filed":false,"modifiable":false},{"code":"0304","name":"IVA retenciones","path":null,"supported":false,"registered":false,"filed":false,"modifiable":false},{"code":"0318","name":"IVA simplificado de confianza","path":"iva.resico","supported":true,"registered":true,"filed":false,"modifiable":false},{"code":"0449","name":"IEPS retenciones por apuestas y sorteos","path":null,"supported":false,"registered":false,"filed":false,"modifiable":false}],"expiresAt":"2026-10-16T09:00:58-06:00"}}}}}},"404":{"description":"No period options of yours have this ID, or they are over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No period options of yours have this ID, or they are over 48 hours old.","errors":[{"code":"not_found","message":"No period options of yours have this ID, or they are over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/prefills":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"loadPrefill","tags":["Prefills"],"summary":"Load the prefill","description":"Asks SAT for the values that it preloaded for the period, as of today. It changes nothing in SAT. The task brings back the `Prefill`: the declaration with nothing answered yet, named by its `prefillSnapshot`. If SAT holds a draft for the period, SAT shows no prefill, so the task fails with `existing_draft`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrefillRequest"},"examples":{"september":{"summary":"September's ISR and IVA","value":{"period":"2026-09","obligations":["isr.resicoIndividual","iva.resico"]}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `Prefill`: read it with [`GET /prefills/{prefillSnapshot}`](#tag/prefills/getPrefill).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA6Y1K2M8Q4R7T"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"prefill","description":"Always `prefill`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","existing_draft","not_offered","obligation_not_registered","unsupported_form"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"queued":{"summary":"Waiting for the session to sign in","value":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"queued","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":null,"completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/prefills/{prefillSnapshot}":{"parameters":[{"$ref":"#/components/parameters/PrefillSnapshot"}],"get":{"operationId":"getPrefill","tags":["Prefills"],"summary":"Retrieve a prefill","description":"Returns a prefill that a task loaded. It does not reach SAT. The API keeps it for 48 hours, and compute takes it on the day it was loaded.","responses":{"200":{"description":"The `Prefill`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Prefill"},"examples":{"september":{"summary":"September's prefill","value":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"prefillSnapshot":"pfl_292632ec4cbbc2f5","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"},"obligations":[{"code":"0168","name":"ISR simplificado de confianza. Personas físicas","path":"isr.resicoIndividual","supported":true,"filed":false,"loaded":true},{"code":"0318","name":"IVA simplificado de confianza","path":"iva.resico","supported":true,"filed":false,"loaded":true}],"declaration":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":null,"source":"caller","editable":true}},"added":{"sat":null,"declared":null,"source":"caller","editable":true},"coOwnership":{"sat":null,"declared":null,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"subtracted":{"sat":null,"declared":null,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"income":100000,"taxableIncome":100000,"rate":2,"tax":2000,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1750,"taxInFavor":0,"amountDue":1750,"amountInFavor":0,"amountToPay":1750,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":0,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":0,"declared":0,"source":"sat","editable":false},"exempt":{"sat":100000,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":0,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":0,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":0,"declared":0,"source":"sat","editable":false},"purchases":{"sat":0,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":750,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":null,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":null,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1750,"prefill":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[{"code":"missing_value","severity":"blocking","path":"isr.resicoIndividual.income.coOwnership","rule":"45700072","message":"Indica si tus ingresos fueron obtenidos a través de copropiedad o sociedad conyugal."},{"code":"sat_rule","severity":"blocking","satField":"4570001.SAT1100106","rule":"45700124","message":"Completa la información de Descuentos, devoluciones y bonificaciones (Descuentos, devoluciones y bonificaciones, 4570001.SAT1100106)"},{"code":"missing_value","severity":"blocking","path":"isr.resicoIndividual.income.discounts.coOwnership","rule":"45700075","message":"El importe debe ser igual o mayor a cero"},{"code":"missing_value","severity":"blocking","path":"isr.resicoIndividual.income.added","rule":"45700200","message":"El campo es obligatorio"},{"code":"sat_rule","severity":"blocking","path":"isr.resicoIndividual.computed.withheldCredited","rule":"45700127","message":"Completa la información de ISR retenido por personas morales"},{"code":"missing_value","severity":"blocking","path":"isr.resicoIndividual.withheld.subtracted","rule":"45700122","message":"El importe debe ser igual o mayor a cero."},{"code":"sat_rule","severity":"blocking","path":"iva.resico.computed.creditable","rule":"45400029","message":"Completa la información correspondiente al IVA acreditable del periodo."},{"code":"missing_value","severity":"blocking","path":"iva.resico.paid.taxedActivities","rule":"45400038","message":"El importe debe ser mayor o igual a cero."},{"code":"missing_value","severity":"blocking","path":"iva.resico.paid.mixedActivities","rule":"45400039","message":"El importe debe ser mayor o igual a cero."}]},"expiresAt":"2026-10-16T09:02:11-06:00"}}}}}},"404":{"description":"No prefill of yours has this snapshot, or it is over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No prefill of yours has this snapshot, or it is over 48 hours old.","errors":[{"code":"not_found","message":"No prefill of yours has this snapshot, or it is over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/drafts/compute":{"post":{"operationId":"computeDraft","tags":["Drafts"],"summary":"Compute the draft","description":"Runs the rules of the form on the prefill of `prefillSnapshot`, with your decisions. Returns the declared values next to the preloaded values, the totals, the amount to pay and what the form still needs. It does not reach SAT, needs no session and saves nothing. The API keeps the prefill until the end of the day that it was loaded.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ComputeRequest"},"examples":{"september":{"summary":"September: cash consultations and IVA paid on expenses","value":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","declaration":{"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"added":2000,"byActivity":{"professionalServices":102000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}},"iva":{"resico":{"paid":{"taxedActivities":0,"mixedActivities":0,"nonCreditable":750}}}}}},"complementaria":{"summary":"The complementaria: 5,000 of cash income instead of 2,000","value":{"prefillSnapshot":"pfl_0a6f57d0094866c2","declaration":{"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"added":5000,"byActivity":{"professionalServices":105000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}},"iva":{"resico":{"paid":{"taxedActivities":0,"mixedActivities":0,"nonCreditable":750}}}}}},"zeros":{"summary":"No decisions: compute lists what the form needs","value":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","declaration":{"obligations":["isr.resicoIndividual","iva.resico"]}}},"isrOnly":{"summary":"Only ISR, on a prefill of only ISR","value":{"prefillSnapshot":"pfl_dc69136226f11e41","declaration":{"obligations":["isr.resicoIndividual"],"isr":{"resicoIndividual":{"income":{"added":2000,"byActivity":{"professionalServices":102000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}}}}}}}}},"responses":{"200":{"description":"The declaration, computed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Declaration"},"examples":{"september":{"summary":"September, nothing pending","value":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":2000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":102000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":102000,"taxableIncome":102000,"rate":2,"tax":2040,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1790,"taxInFavor":0,"amountDue":1790,"amountInFavor":0,"amountToPay":1790,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":0,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":0,"declared":0,"source":"sat","editable":false},"exempt":{"sat":100000,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":0,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":0,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":0,"declared":0,"source":"sat","editable":false},"purchases":{"sat":0,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":750,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1790,"prefill":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[]}},"pending":{"summary":"Income by activity still missing","value":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":false,"source":"caller","editable":true},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":100000,"taxableIncome":100000,"rate":2,"tax":2000,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1750,"taxInFavor":0,"amountDue":1750,"amountInFavor":0,"amountToPay":1750,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":0,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":0,"declared":0,"source":"sat","editable":false},"exempt":{"sat":100000,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":0,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":0,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":0,"declared":0,"source":"sat","editable":false},"purchases":{"sat":0,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":750,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1750,"prefill":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[{"code":"sat_rule","severity":"blocking","path":"isr.resicoIndividual.computed.income","rule":"45700114","message":"Da clic en \"Capturar\" para detallar tus ingresos cobrados y amparados por facturas del mes"},{"code":"sat_rule","severity":"blocking","satField":"4570001.SAT1100501","rule":"45700115","message":"Captura los registros hasta detallar el total de los Ingresos cobrados del mes (Monto por detallar, 4570001.SAT1100501)"}]}},"complementaria":{"summary":"The complementaria owes 60 more","value":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"complementaria","complementaria":"modification","reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":5000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":105000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":1790,"declared":1790,"source":"sat","editable":false}},"computed":{"income":105000,"taxableIncome":105000,"rate":2,"tax":2100,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1850,"taxInFavor":0,"amountDue":1850,"amountInFavor":0,"amountToPay":60,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":0,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":0,"declared":0,"source":"sat","editable":false},"exempt":{"sat":100000,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":0,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":0,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":0,"declared":0,"source":"sat","editable":false},"purchases":{"sat":0,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":750,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":60,"prefill":{"prefillSnapshot":"pfl_0a6f57d0094866c2","fetchedAt":"2026-10-16T11:40:52-06:00","filingOn":"2026-10-16","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-15","provisionalPayments":"2026-10-15"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[],"previousFilings":[{"obligation":"isr.resicoIndividual","filedOn":"2026-10-14","amountToPay":1790,"paid":1790,"paidOn":"2026-10-15"},{"obligation":"iva.resico","filedOn":"2026-10-14","amountToPay":0,"paid":null,"paidOn":null}]}},"isrOnly":{"summary":"Only ISR: IVA is registered and not filed","value":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":2000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":102000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":102000,"taxableIncome":102000,"rate":2,"tax":2040,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1790,"taxInFavor":0,"amountDue":1790,"amountInFavor":0,"amountToPay":1790,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"amountToPay":1790,"prefill":{"prefillSnapshot":"pfl_dc69136226f11e41","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[{"code":"unlisted_obligation","severity":"warning","obligation":"0318","message":"Obligation 0318, IVA simplificado de confianza, is registered for 2026-09 and this declaration does not file it."}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"409":{"description":"Nothing was computed, for one of these causes:\n\n- Your account did not load a prefill with this `prefillSnapshot` today, in Mexico City time.\n- The declaration lists other obligations than the prefill loaded.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["prefill_required","obligations_mismatch"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"prefillRequired":{"summary":"A prefill of another day","value":{"type":"https://api.satsdk.com/problems/prefill_required","title":"Prefill required","status":409,"detail":"No prefill with this snapshot was loaded today. Load it again.","errors":[{"code":"prefill_required","message":"No prefill with this snapshot was loaded today. Load it again."}]}},"obligationsMismatch":{"summary":"Only ISR listed, on a prefill of ISR and IVA","value":{"type":"https://api.satsdk.com/problems/obligations_mismatch","title":"Obligations mismatch","status":409,"detail":"The declaration lists other obligations than the prefill loaded. Nothing was computed.","errors":[{"code":"obligations_mismatch","path":"declaration.obligations","message":"The declaration lists isr.resicoIndividual, and the prefill loaded isr.resicoIndividual, iva.resico. List exactly the obligations the prefill loaded."}]}}}}}},"422":{"description":"Nothing was computed, for one of these causes:\n\n- A rule of the form that the API does not support yet.\n- A block for an obligation that the declaration does not list.\n- A value that the form does not take from this taxpayer.\n- A value that SAT's form sets in this declaration.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["unsupported_form","obligation_not_listed","not_applicable","set_by_form"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"unsupported":{"summary":"A new form version","value":{"type":"https://api.satsdk.com/problems/unsupported_form","title":"Unsupported form","status":422,"detail":"The form has a rule the forms engine does not run yet: Rule 45400999 uses SUMAGRID, which is not supported yet","errors":[{"code":"unsupported_form","message":"The form has a rule the forms engine does not run yet: Rule 45400999 uses SUMAGRID, which is not supported yet"}]}},"notListed":{"summary":"A block for an obligation that the declaration does not list","value":{"type":"https://api.satsdk.com/problems/obligation_not_listed","title":"Obligation not listed","status":422,"detail":"The declaration has a block for an obligation that it does not list. Nothing was computed.","errors":[{"code":"obligation_not_listed","path":"declaration.iva.resico","message":"`iva.resico` has a block, and `obligations` does not list it."}]}},"notApplicable":{"summary":"A value only personas morales file, from a persona física","value":{"type":"https://api.satsdk.com/problems/not_applicable","title":"Not applicable","status":422,"detail":"The declaration has a value that the form does not take from this taxpayer. Nothing was computed.","errors":[{"code":"not_applicable","path":"declaration.iva.resico.immediateRefund","message":"SAT's form takes `iva.resico.immediateRefund` only from personas morales."}]}},"setByForm":{"summary":"A value the form computes, sent as a decision","value":{"type":"https://api.satsdk.com/problems/set_by_form","title":"Set by the form","status":422,"detail":"`isr.resicoIndividual.payment.charges.surcharges` is read-only in this declaration: SAT's form sets it to 0. Leave it out.","errors":[{"code":"set_by_form","path":"declaration.isr.resicoIndividual.payment.charges.surcharges","satField":"4570017.457C9","expected":50,"actual":0,"message":"`isr.resicoIndividual.payment.charges.surcharges` is read-only in this declaration: SAT's form sets it to 0. Leave it out."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/drafts":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"saveDraft","tags":["Drafts"],"summary":"Save the draft","description":"Saves the declaration on the portal as the draft of the period, and does not file it. SAT runs its checks and its *vista previa* (preview) on the draft. The task brings back the `Draft`, named by its `draftSnapshot`. If the prefill changed after `prefillSnapshot`, it fails with `prefill_changed`. If SAT holds a draft for the period, it fails with `existing_draft`, unless `replaceDraft` is true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftRequest"},"examples":{"september":{"summary":"September, on the prefill the taxpayer saw","value":{"declaration":{"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"added":2000,"byActivity":{"professionalServices":102000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}},"iva":{"resico":{"paid":{"taxedActivities":0,"mixedActivities":0,"nonCreditable":750}}}},"prefillSnapshot":"pfl_292632ec4cbbc2f5"}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `Draft`: read it with [`GET /drafts/{draftSnapshot}`](#tag/drafts/getDraft).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA6Z5B3N9W2X6C"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"draft","description":"Always `draft`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","prefill_changed","obligations_mismatch","existing_draft","not_offered","obligation_not_registered","sat_rule","unsupported_form","obligation_not_listed","not_applicable","set_by_form","authorized_coefficient_mismatch"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is saving it","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/drafts/{draftSnapshot}":{"parameters":[{"$ref":"#/components/parameters/DraftSnapshot"}],"get":{"operationId":"getDraft","tags":["Drafts"],"summary":"Retrieve a draft","description":"Returns a draft that your account saved, or that a draft query read from SAT. It does not reach SAT, so SAT may hold another draft by now: query the draft to know. The API keeps it for 48 hours.","responses":{"200":{"description":"The `Draft`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Draft"},"examples":{"saved":{"summary":"September's draft, saved and checked by SAT","value":{"declaration":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":100000,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":0,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":2000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":102000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":250,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":102000,"taxableIncome":102000,"rate":2,"tax":2040,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1790,"taxInFavor":0,"amountDue":1790,"amountInFavor":0,"amountToPay":1790,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":0,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":0,"declared":0,"source":"sat","editable":false},"exempt":{"sat":100000,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":0,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":0,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":0,"declared":0,"source":"sat","editable":false},"purchases":{"sat":0,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":750,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":0,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1790,"prefill":{"prefillSnapshot":"pfl_292632ec4cbbc2f5","fetchedAt":"2026-10-14T09:02:11-06:00","filingOn":"2026-10-14","dueOn":"2026-10-19","cutoffs":{"issuedInvoices":"2026-10-13","provisionalPayments":"2026-10-13"}},"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[]},"draftSnapshot":"drf_b4008fc2e529a035","savedAt":"2026-10-14T09:20:37-06:00","checks":{"otis":{"status":"passed","messages":[]},"envio":{"status":"passed","messages":[]},"vistaPrevia":{"amountToPay":1790,"matches":true}},"expiresAt":"2026-10-16T09:20:37-06:00"}},"read":{"summary":"September's draft, read back from SAT by a query","value":{"draftSnapshot":"drf_b4008fc2e529a035","savedAt":"2026-10-14T09:20:37-06:00","checks":{"otis":{"status":"not_run","messages":[]},"envio":{"status":"not_run","messages":[]},"vistaPrevia":{"amountToPay":null,"matches":null}},"expiresAt":"2026-10-16T09:24:48-06:00","declaration":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":null,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":null,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":2000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":102000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":null,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":null,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":102000,"taxableIncome":102000,"rate":2,"tax":2040,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1790,"taxInFavor":0,"amountDue":1790,"amountInFavor":0,"amountToPay":1790,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":null,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":null,"declared":0,"source":"sat","editable":false},"exempt":{"sat":null,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":null,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":null,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":null,"declared":0,"source":"sat","editable":false},"purchases":{"sat":null,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":null,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":null,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1790,"prefill":null,"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[]}}}}}}},"404":{"description":"No draft that your account saved or queried has this snapshot, or it is over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No draft that your account saved or queried has this snapshot, or it is over 48 hours old.","errors":[{"code":"not_found","message":"No draft that your account saved or queried has this snapshot, or it is over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}},"delete":{"operationId":"deleteDraft","tags":["Drafts"],"summary":"Delete the draft","description":"Deletes this draft from SAT, and files nothing. If SAT holds another draft for the period, it fails with `draft_changed`. If SAT holds none, it fails with `draft_not_found`. The draft can be one that someone saved on SAT's portal, so delete it only with the approval of the taxpayer.","parameters":[{"$ref":"#/components/parameters/SatSession"}],"responses":{"202":{"description":"The task. It completes when SAT has done it.","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA6Y8D4F6H8J1K"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"draft_deletion","description":"Always `draft_deletion`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","draft_not_found","draft_changed","not_offered"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is deleting it","value":{"id":"tsk_01JA6Y8D4F6H8J1K","action":"draft_deletion","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:12:05-06:00","startedAt":"2026-10-14T09:12:05-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"No session of yours has this ID, or no draft that your account saved or queried in the last 48 hours has this `draftSnapshot`. Nothing reached SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"sessionNotFound":{"summary":"Unknown session","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No session of yours has the ID ses_01JA6X7N3K5M7P9S.","errors":[{"code":"not_found","message":"No session of yours has the ID ses_01JA6X7N3K5M7P9S."}]}},"draftNotFound":{"summary":"A draft nobody saved or queried","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No draft of yours has the snapshot drf_b4008fc2e529a030.","errors":[{"code":"not_found","message":"No draft of yours has the snapshot drf_b4008fc2e529a030."}]}}}}}},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/drafts/{draftSnapshot}/filings":{"parameters":[{"$ref":"#/components/parameters/DraftSnapshot"},{"$ref":"#/components/parameters/SatSession"},{"$ref":"#/components/parameters/IdempotencyKey"}],"post":{"operationId":"fileDraft","tags":["Filings"],"summary":"File the draft","description":"Files this draft, as SAT saved and checked it. It sends no decisions, so nothing is computed again. The task brings back the `Filing`. If SAT holds another draft for the period, it fails with `draft_changed`. If the draft was saved on an earlier day, it fails with `draft_expired`. If it charges another amount than `expectedAmountToPay`, it fails with `amount_mismatch`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftFilingRequest"},"examples":{"september":{"summary":"Files September's draft, 1,790","value":{"expectedAmountToPay":1790,"metadata":{"workflowId":"wf_september_XAXX010101000"}}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `Filing`: read it with [`GET /filings/{operationNumber}`](#tag/filings/getFiling).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA9C3S6Q4P7N2J"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"draft_filing","description":"Always `draft_filing`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","draft_not_found","draft_changed","draft_expired","amount_mismatch","not_offered","sat_rule","unsupported_form","filing_unconfirmed"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is filing the draft","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"No session of yours has this ID, or no draft that your account saved or queried in the last 48 hours has this `draftSnapshot`. Nothing reached SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"sessionNotFound":{"summary":"Unknown session","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No session of yours has the ID ses_01JA6X7N3K5M7P9S.","errors":[{"code":"not_found","message":"No session of yours has the ID ses_01JA6X7N3K5M7P9S."}]}},"draftNotFound":{"summary":"A draft nobody saved or queried","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No draft of yours has the snapshot drf_b4008fc2e529a030.","errors":[{"code":"not_found","message":"No draft of yours has the snapshot drf_b4008fc2e529a030."}]}}}}}},"409":{"description":"The session is closed, or another filing of the declaration is waiting or with SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["session_closed","filing_in_progress"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"closed":{"summary":"The session closed","value":{"type":"https://api.satsdk.com/problems/session_closed","title":"Session closed","status":409,"detail":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again.","errors":[{"code":"session_closed","message":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again."}]}},"filingInProgress":{"summary":"Another filing of the declaration is with SAT","value":{"type":"https://api.satsdk.com/problems/filing_in_progress","title":"Filing in progress","status":409,"detail":"The 2026-09 declaration is already being filed (tsk_01JA9C3S6Q4P7N2J, with SAT). Nothing was filed. Follow that task. When it ends, file again only if it filed nothing.","errors":[{"code":"filing_in_progress","path":"period","message":"The 2026-09 declaration is already being filed (tsk_01JA9C3S6Q4P7N2J, with SAT). Nothing was filed. Follow that task. When it ends, file again only if it filed nothing."}]}}}}}},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"default":{"$ref":"#/components/responses/Problem"}}}},"/draft-queries":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"queryDraft","tags":["Drafts"],"summary":"Query the draft","description":"Asks SAT for the draft that it holds for a declaration of the period, and changes nothing in SAT. The task brings back the `DraftQuery`, with the draft or none. A draft that it finds can be read, filed and deleted by its `draftSnapshot`. If the draft cannot be read back, the task fails with `sat_unavailable`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftQueryRequest"},"examples":{"september":{"summary":"September's normal declaration","value":{"period":"2026-09"}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `DraftQuery`: read it with [`GET /draft-queries/{id}`](#tag/drafts/getDraftQuery).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA6ZB7K2M4N6P8"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"draft_query","description":"Always `draft_query`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","not_offered","unsupported_form"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is opening the draft","value":{"id":"tsk_01JA6ZB7K2M4N6P8","action":"draft_query","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:24:10-06:00","startedAt":"2026-10-14T09:24:10-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/draft-queries/{id}":{"parameters":[{"$ref":"#/components/parameters/DraftQueryId"}],"get":{"operationId":"getDraftQuery","tags":["Drafts"],"summary":"Retrieve a draft query","description":"Returns what SAT answered to a draft query. It does not reach SAT. The API keeps it for 48 hours.","responses":{"200":{"description":"The `DraftQuery`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftQuery"},"examples":{"found":{"summary":"SAT held September's draft","value":{"id":"drq_01JA6ZB8M3N5P7Q9","period":"2026-09","complementaria":null,"queriedAt":"2026-10-14T09:24:48-06:00","draft":{"draftSnapshot":"drf_b4008fc2e529a035","savedAt":"2026-10-14T09:20:37-06:00","checks":{"otis":{"status":"not_run","messages":[]},"envio":{"status":"not_run","messages":[]},"vistaPrevia":{"amountToPay":null,"matches":null}},"expiresAt":"2026-10-16T09:24:48-06:00","declaration":{"taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"invoiced":{"sat":null,"declared":100000,"source":"sat","editable":false},"discounts":{"invoiced":{"sat":null,"declared":0,"source":"sat","editable":false},"coOwnership":{"sat":null,"declared":0,"source":"caller","editable":true}},"added":{"sat":null,"declared":2000,"source":"caller","editable":true},"byActivity":{"sat":null,"declared":{"professionalServices":102000},"source":"caller","editable":true,"options":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"coOwnership":{"sat":null,"declared":false,"source":"caller","editable":true}},"withheld":{"invoiced":{"sat":null,"declared":250,"source":"sat","editable":false},"added":{"sat":null,"declared":0,"source":"caller","editable":true},"subtracted":{"sat":null,"declared":0,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":null,"declared":0,"source":"sat","editable":false},"offsets":{"sat":null,"declared":false,"source":"caller","editable":true},"incentives":{"sat":null,"declared":false,"source":"caller","editable":true,"options":[]}},"computed":{"income":102000,"taxableIncome":102000,"rate":2,"tax":2040,"priorPayments":0,"withheld":250,"withheldCredited":250,"taxDue":1790,"taxInFavor":0,"amountDue":1790,"amountInFavor":0,"amountToPay":1790,"recentPaymentAmount":0},"invoices":{"income":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000}},"withheld":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"withheld":250}}}}},"iva":{"resico":{"activities":{"taxedAt16":{"sat":null,"declared":0,"source":"sat","editable":false},"taxedAt8":{"sat":null,"declared":0,"source":"sat","editable":false},"exempt":{"sat":null,"declared":100000,"source":"sat","editable":false},"notSubject":{"sat":null,"declared":0,"source":"sat","editable":false}},"withheld":{"sat":null,"declared":0,"source":"sat","editable":false},"returns":{"sales":{"sat":null,"declared":0,"source":"sat","editable":false},"purchases":{"sat":null,"declared":0,"source":"sat","editable":false}},"paid":{"invoiced":{"sat":null,"declared":750,"source":"sat","editable":false},"taxedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"mixedActivities":{"sat":null,"declared":0,"source":"caller","editable":true},"nonCreditable":{"sat":null,"declared":750,"source":"caller","editable":true}},"payment":{"amountPaid":{"sat":null,"declared":0,"source":"sat","editable":false}},"computed":{"taxAt16":0,"taxAt8":0,"tax":0,"creditable":0,"netTax":0,"taxDue":0,"taxInFavor":0,"amountDue":0,"amountInFavor":0,"amountToPay":0,"recentPaymentAmount":0},"invoices":{"activities":{"exempt":{"singlePayment":{"cancelled":0,"valid":4,"subtotal":100000,"discount":0,"net":100000,"base":100000}}},"paid":{"singlePayment":{"cancelled":0,"valid":3,"subtotal":4688,"discount":0,"net":4688,"taxAt8":0,"taxAt16":750}}}}},"amountToPay":1790,"prefill":null,"engine":{"status":"verified","formVersion":"tmp-2026-170e602f","fingerprint":"170e602fe269a1f4","reasons":[]},"issues":[]}},"expiresAt":"2026-10-16T09:24:48-06:00"}},"none":{"summary":"SAT held no draft","value":{"id":"drq_01JA6Y7C3E5G7J9M","period":"2026-09","complementaria":null,"queriedAt":"2026-10-14T09:13:20-06:00","draft":null,"expiresAt":"2026-10-16T09:13:20-06:00"}}}}}},"404":{"description":"No draft query of yours has this ID, or it is over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No draft query of yours has this ID, or it is over 48 hours old.","errors":[{"code":"not_found","message":"No draft query of yours has this ID, or it is over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/filings":{"parameters":[{"$ref":"#/components/parameters/SatSession"},{"$ref":"#/components/parameters/IdempotencyKey"}],"post":{"operationId":"fileDeclaration","tags":["Filings"],"summary":"File a declaration","description":"Files the declaration in one task, without a reviewed draft. The task loads today's prefill, computes the declaration and saves it as the draft of the period. Then SAT checks and files it. The task brings back the `Filing`. If the declaration charges another amount than `expectedAmountToPay`, it fails with `amount_mismatch`. If SAT holds a draft, it fails with `existing_draft`, unless `replaceDraft` is true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DirectFilingRequest"},"examples":{"september":{"summary":"Files September, if it comes to 1,790","value":{"period":"2026-09","declaration":{"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"added":2000,"byActivity":{"professionalServices":102000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}},"iva":{"resico":{"paid":{"taxedActivities":0,"mixedActivities":0,"nonCreditable":750}}}},"expectedAmountToPay":1790,"metadata":{"workflowId":"wf_september_XAXX010101000"}}},"complementaria":{"summary":"Files the complementaria, if it comes to 60 more","value":{"period":"2026-09","complementaria":"modification","declaration":{"obligations":["isr.resicoIndividual","iva.resico"],"isr":{"resicoIndividual":{"income":{"added":5000,"byActivity":{"professionalServices":105000},"discounts":{"coOwnership":0},"coOwnership":false},"withheld":{"added":0,"subtracted":0},"payment":{"offsets":false,"incentives":false}}},"iva":{"resico":{"paid":{"taxedActivities":0,"mixedActivities":0,"nonCreditable":750}}}},"expectedAmountToPay":60}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `Filing`: read it with [`GET /filings/{operationNumber}`](#tag/filings/getFiling).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA9C4T7R5V8M3K"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"filing","description":"Always `filing`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","amount_mismatch","existing_draft","not_offered","obligation_not_registered","sat_rule","unsupported_form","obligation_not_listed","not_applicable","set_by_form","authorized_coefficient_mismatch","filing_unconfirmed"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is filing it","value":{"id":"tsk_01JA9C4T7R5V8M3K","action":"filing","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"description":"The session is closed, or another filing of the declaration is waiting or with SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["session_closed","filing_in_progress"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"closed":{"summary":"The session closed","value":{"type":"https://api.satsdk.com/problems/session_closed","title":"Session closed","status":409,"detail":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again.","errors":[{"code":"session_closed","message":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again."}]}},"filingInProgress":{"summary":"Another filing of the declaration is with SAT","value":{"type":"https://api.satsdk.com/problems/filing_in_progress","title":"Filing in progress","status":409,"detail":"The 2026-09 declaration is already being filed (tsk_01JA9C4T7R5V8M3K, with SAT). Nothing was filed. Follow that task. When it ends, file again only if it filed nothing.","errors":[{"code":"filing_in_progress","path":"period","message":"The 2026-09 declaration is already being filed (tsk_01JA9C4T7R5V8M3K, with SAT). Nothing was filed. Follow that task. When it ends, file again only if it filed nothing."}]}}}}}},"422":{"$ref":"#/components/responses/IdempotencyKeyReused"},"default":{"$ref":"#/components/responses/Problem"}}}},"/filings/{operationNumber}":{"parameters":[{"$ref":"#/components/parameters/OperationNumber"}],"get":{"operationId":"getFiling","tags":["Filings"],"summary":"Retrieve a filing","description":"Returns a declaration that your account filed, as SAT acknowledged it in the acuse. It does not reach SAT. The API keeps it for 48 hours. For what SAT has on record later, such as its payment, query the filings: they answer each filing in this same shape.","responses":{"200":{"description":"The `Filing`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Filing"},{"type":"object","required":["expiresAt"],"properties":{"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}}]},"examples":{"september":{"summary":"September, filed: 1,790 to pay","value":{"operationNumber":"100000000009","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","periodicity":"monthly","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"filedOn":"2026-10-14","dueOn":"2026-10-19","inEffect":true,"payment":{"reference":"04260AAA000000000009","amountToPay":1790,"referenceExpiresOn":"2026-10-19","paid":false},"acusePdfUrl":"https://api.satsdk.com/v1/files/100000000009-acuse.pdf?expires=1760628704&signature=9b2e71","expiresAt":"2026-10-16T09:31:44-06:00"}}}}}},"404":{"description":"Your account filed no declaration with this operation number in the last 48 hours. Query the filings to read it from SAT.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"Your account filed no declaration with this operation number in the last 48 hours. Query the filings to read it from SAT.","errors":[{"code":"not_found","message":"Your account filed no declaration with this operation number in the last 48 hours. Query the filings to read it from SAT."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/filing-queries":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"queryFilings","tags":["Filing queries"],"summary":"Query the filings","description":"Asks SAT for the declarations that it has on record as filed in a year, or in one month of it. For each filing in effect that SAT has no payment of, it reads the acuse for the amount to pay. It changes nothing in SAT. The task brings back the `FilingQuery`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingQueryRequest"},"examples":{"year":{"summary":"Every filing of 2026","value":{"year":2026}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `FilingQuery`: read it with [`GET /filing-queries/{id}`](#tag/filing-queries/getFilingQuery).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA9C6E8G2H4J6N"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"filing_query","description":"Always `filing_query`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","unsupported_form"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is listing the filings","value":{"id":"tsk_01JA9C6E8G2H4J6N","action":"filing_query","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:32:10-06:00","startedAt":"2026-10-14T09:32:10-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/filing-queries/{id}":{"parameters":[{"$ref":"#/components/parameters/FilingQueryId"}],"get":{"operationId":"getFilingQuery","tags":["Filing queries"],"summary":"Retrieve a filing query","description":"Returns what SAT answered to a filing query: the filings that it had on record at `queriedAt`. It does not reach SAT. The API keeps it for 48 hours.","responses":{"200":{"description":"The `FilingQuery`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingQuery"},"examples":{"year":{"summary":"The filings of 2026: September owes 1,790","value":{"id":"fiq_01JA9C6F9H3J5K7P","year":2026,"month":null,"queriedAt":"2026-10-14T09:32:41-06:00","filings":[{"operationNumber":"100000000009","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","periodicity":"monthly","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"filedOn":"2026-10-14","dueOn":"2026-10-19","inEffect":true,"payment":{"reference":"04260AAA000000000009","amountToPay":1790,"referenceExpiresOn":"2026-10-19","paid":false},"acusePdfUrl":"https://api.satsdk.com/v1/files/100000000009-acuse.pdf?expires=1760628704&signature=9b2e71"},{"operationNumber":"100000000008","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-08","periodicity":"monthly","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"filedOn":"2026-09-15","dueOn":"2026-09-17","inEffect":true,"payment":null,"acusePdfUrl":null},{"operationNumber":"100000000007","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-07","periodicity":"monthly","type":"normal","complementaria":null,"reason":null,"obligations":["isr.resicoIndividual","iva.resico"],"filedOn":"2026-08-12","dueOn":"2026-08-17","inEffect":true,"payment":{"reference":"04260AAA000000000007","amountToPay":null,"referenceExpiresOn":null,"paid":true},"acusePdfUrl":null}],"expiresAt":"2026-10-16T09:32:41-06:00"}}}}}},"404":{"description":"No filing query of yours has this ID, or it is over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No filing query of yours has this ID, or it is over 48 hours old.","errors":[{"code":"not_found","message":"No filing query of yours has this ID, or it is over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/filing-documents":{"parameters":[{"$ref":"#/components/parameters/SatSession"}],"post":{"operationId":"requestFilingDocument","tags":["Filing queries"],"summary":"Read a PDF of a filing","description":"Asks SAT for a PDF that it keeps of a filing: the declaration with every value, the acuse, or the payment that SAT identified. It changes nothing in SAT. The task brings back the `FilingDocument`, with a link to the PDF and its text. If SAT lists no such filing in `year`, the task fails with `filing_not_found`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDocumentRequest"},"examples":{"acuse":{"summary":"September's acuse","value":{"operationNumber":"100000000009","year":2026,"kind":"acuse"}}}}}},"responses":{"202":{"description":"The task. When it completes, its `resource` links to the `FilingDocument`: read it with [`GET /filing-documents/{id}`](#tag/filing-queries/getFilingDocument).","headers":{"Location":{"description":"URL of the task, for polling it.","required":true,"schema":{"type":"string","format":"uri"},"example":"https://api.satsdk.com/v1/tasks/tsk_01JA9C7F9H3J5K7M"}},"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Task"},{"type":"object","properties":{"action":{"const":"filing_document","description":"Always `filing_document`."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","filing_not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}}]},"examples":{"running":{"summary":"SAT is sending the PDF","value":{"id":"tsk_01JA9C7F9H3J5K7M","action":"filing_document","status":"running","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:33:40-06:00","startedAt":"2026-10-14T09:33:40-06:00","completedAt":null,"resource":null,"problem":null}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/SessionNotFound"},"409":{"$ref":"#/components/responses/SessionConflict"},"default":{"$ref":"#/components/responses/Problem"}}}},"/filing-documents/{id}":{"parameters":[{"$ref":"#/components/parameters/FilingDocumentId"}],"get":{"operationId":"getFilingDocument","tags":["Filing queries"],"summary":"Retrieve a filing document","description":"Returns a PDF of a filing that a task read, and its text. It does not reach SAT. The API keeps it, and its link, for 48 hours.","responses":{"200":{"description":"The `FilingDocument`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FilingDocument"},"examples":{"acuse":{"summary":"September's acuse","value":{"id":"fdc_01JA9C7G1J4K6M8Q","operationNumber":"100000000009","kind":"acuse","pdfUrl":"https://api.satsdk.com/v1/files/fdc_01JA9C7G1J4K6M8Q.pdf?expires=1760628832&signature=4f1c9a","text":"ACUSE DE RECIBO\nDECLARACIÓN PROVISIONAL O DEFINITIVA DE IMPUESTOS FEDERALES\nRFC: XAXX010101000 Hoja 1 de 2\nTipo de declaración: Normal\nPeriodicidad: Mensual Período de la declaración: Septiembre\nEjercicio: 2026 Fecha y hora de presentación: 14/10/2026 09:31\nMedio de presentación: Internet Vencimiento Obligación: 19/10/2026\nNúmero de operación: 100000000009\nImpuestos que declara:\nConcepto de pago 1: ISR simplificado de confianza. Personas físicas\nA cargo: 1,790\nCantidad a pagar: 1,790\n…","expiresAt":"2026-10-16T09:33:52-06:00"}}}}}},"404":{"description":"No filing document of yours has this ID, or it is over 48 hours old.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown, or discarded","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No filing document of yours has this ID, or it is over 48 hours old.","errors":[{"code":"not_found","message":"No filing document of yours has this ID, or it is over 48 hours old."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}},"/tasks/{id}":{"parameters":[{"$ref":"#/components/parameters/TaskId"}],"get":{"operationId":"getTask","tags":["Tasks"],"summary":"Retrieve a task","description":"Returns the task: where SAT's work is, then a link to what it brought back, or the `problem`. Call it when the task's event reaches your webhook endpoint, or every few seconds to poll.","responses":{"200":{"description":"The task.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Task"},"examples":{"periodOptions":{"summary":"Reading the period options: September's options, read once the session signed in","value":{"id":"tsk_01JA6Y0R5T7W9Y2B","action":"period_options","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:00:58-06:00","resource":{"id":"pop_01JA6Y0S6V8X1Z3C","url":"https://api.satsdk.com/v1/period-options/pop_01JA6Y0S6V8X1Z3C"},"problem":null}},"periodNotOffered":{"summary":"Reading the period options: Options for a month that has not started","value":{"id":"tsk_01JA6Y0R5T7W9Y2B","action":"period_options","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-11","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:00:58-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/not_offered","title":"Not offered","status":422,"detail":"SAT offers no declaration for 2026-11 yet. Nothing was read.","errors":[{"code":"not_offered","message":"SAT offers no declaration for 2026-11 yet. Nothing was read."}]}}},"prefill":{"summary":"Loading the prefill: The prefill, loaded once the session signed in","value":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:02:11-06:00","resource":{"id":"pfl_292632ec4cbbc2f5","url":"https://api.satsdk.com/v1/prefills/pfl_292632ec4cbbc2f5"},"problem":null}},"prefillOfDraft":{"summary":"Loading the prefill: A prefill asked for while SAT holds a draft","value":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:01:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/existing_draft","title":"Existing draft","status":409,"detail":"SAT holds a draft for the period, so it shows no prefill. Query the draft, or delete it and load the prefill again.","errors":[{"code":"existing_draft","message":"SAT holds a draft for the period, so it shows no prefill. Query the draft, or delete it and load the prefill again."}]}}},"signInRejected":{"summary":"Loading the prefill: Queued on a session whose login SAT refused","value":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":null,"completedAt":"2026-10-14T09:00:31-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/sign_in_rejected","title":"Sign-in rejected","status":422,"detail":"SAT refused the session's login, so the task never ran. Check the e.firma or the CIEC before you sign in again.","errors":[{"code":"sign_in_rejected","message":"SAT refused the session's login, so the task never ran. Check the e.firma or the CIEC before you sign in again."}]}}},"notRegistered":{"summary":"Loading the prefill: The prefill lists an obligation that the taxpayer does not have","value":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:01:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/obligation_not_registered","title":"Obligation not registered","status":422,"detail":"The prefill lists an obligation that the taxpayer is not registered for. Nothing was loaded.","errors":[{"code":"obligation_not_registered","path":"obligations","obligation":"0318","message":"The taxpayer is not registered for obligation 0318, IVA simplificado de confianza, in 2026-09."}]}}},"savedDraft":{"summary":"Saving the draft: September's draft, saved and checked by SAT","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":{"id":"drf_b4008fc2e529a035","url":"https://api.satsdk.com/v1/drafts/drf_b4008fc2e529a035"},"problem":null}},"prefillChanged":{"summary":"Saving the draft: An expense invoice landed: SAT now preloads 820 of IVA paid","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/prefill_changed","title":"Prefill changed","status":409,"detail":"The prefill changed after the snapshot that you sent. Nothing was saved.","errors":[{"code":"prefill_changed","expected":"pfl_292632ec4cbbc2f5","actual":"pfl_db9f6fa95170bfd1","message":"The prefill changed after the snapshot you sent. Load the prefill again.","changes":[{"path":"iva.resico.paid.invoiced","satField":"4540006.SAT1200601","label":"IVA pagado en gastos y adquisiciones","before":750,"after":820}]}]}}},"rejected":{"summary":"Saving the draft: The form's rules reject a value","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/sat_rule","title":"Rejected by the form's rules","status":422,"detail":"The form's rules reject 1 value. Nothing was saved.","errors":[{"path":"declaration.isr.resicoIndividual.income.coOwnership[0].members","code":"sat_rule","rule":"1045700233","satField":"4570021.ARRCOP14","message":"Debes registrar a todos los integrantes de la Copropiedad, Sociedad conyugal o Sucesión, hasta detallar el 100.00%."}]}}},"existingDraft":{"summary":"Saving the draft: SAT holds a draft for the period","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/existing_draft","title":"Existing draft","status":409,"detail":"SAT holds a draft for 2026-09. Send replaceDraft to replace it.","errors":[{"code":"existing_draft","message":"SAT holds a draft for 2026-09. Send replaceDraft to replace it."}]}}},"signedOut":{"summary":"Saving the draft: SAT ended the session during the task","value":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/signed_out","title":"Signed out","status":409,"detail":"SAT ended the session. Nothing was saved: sign in again and send the request again.","errors":[{"code":"signed_out","message":"SAT ended the session. Nothing was saved: sign in again and send the request again."}]}}},"draftRead":{"summary":"Querying the draft: September's draft, queried","value":{"id":"tsk_01JA6ZB7K2M4N6P8","action":"draft_query","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:24:10-06:00","startedAt":"2026-10-14T09:24:10-06:00","completedAt":"2026-10-14T09:24:48-06:00","resource":{"id":"drq_01JA6ZB8M3N5P7Q9","url":"https://api.satsdk.com/v1/draft-queries/drq_01JA6ZB8M3N5P7Q9"},"problem":null}},"draftDeleted":{"summary":"Deleting the draft: The draft that SAT held, deleted","value":{"id":"tsk_01JA6Y8D4F6H8J1K","action":"draft_deletion","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:12:05-06:00","startedAt":"2026-10-14T09:12:05-06:00","completedAt":"2026-10-14T09:12:31-06:00","resource":null,"problem":null}},"filed":{"summary":"Filing the draft: Filed","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:44-06:00","resource":{"id":"100000000009","url":"https://api.satsdk.com/v1/filings/100000000009"},"problem":null}},"unconfirmed":{"summary":"Filing the draft: SAT received the declaration and gave no acuse","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/filing_unconfirmed","title":"Filing unconfirmed","status":502,"detail":"SAT received the 2026-09 declaration but gave no acuse. Query the filings of 2026-09 before you file again.","errors":[{"code":"filing_unconfirmed","message":"SAT received the 2026-09 declaration but gave no acuse. Query the filings of 2026-09 before you file again."}]}}},"amountMismatch":{"summary":"Filing the draft: The taxpayer confirmed another amount","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/amount_mismatch","title":"Amount mismatch","status":409,"detail":"The declaration charges 1,790, not 1,800. Nothing was filed.","errors":[{"code":"amount_mismatch","expected":1800,"actual":1790,"message":"The declaration charges 1,790, not 1,800."}]}}},"draftChanged":{"summary":"Filing the draft: The draft was edited on SAT's portal after the taxpayer approved it","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/draft_changed","title":"Draft changed","status":409,"detail":"SAT holds another draft for 2026-09 than the one of draftSnapshot. Nothing was filed.","errors":[{"code":"draft_changed","path":"draftSnapshot","expected":"drf_b4008fc2e529a035","actual":"drf_018cdd61b5bc6f34","message":"SAT holds another draft for 2026-09 than the one of draftSnapshot."}]}}},"draftExpired":{"summary":"Filing the draft: A draft of yesterday, submitted today","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/draft_expired","title":"Draft expired","status":409,"detail":"The draft was saved on 2026-10-13. SAT computed it as of that day, so it cannot be filed on 2026-10-14. Delete it, load the prefill and save again. Nothing was filed.","errors":[{"code":"draft_expired","message":"The draft was saved on 2026-10-13. SAT computed it as of that day, so it cannot be filed on 2026-10-14. Delete it, load the prefill and save again. Nothing was filed."}]}}},"draftNotFound":{"summary":"Filing the draft: No draft on SAT for the period","value":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/draft_not_found","title":"Draft not found","status":409,"detail":"SAT holds no draft of the normal declaration for 2026-09. Nothing was filed.","errors":[{"code":"draft_not_found","message":"SAT holds no draft of the normal declaration for 2026-09. Nothing was filed."}]}}},"filedDirectly":{"summary":"Filing a declaration: Filed in one task","value":{"id":"tsk_01JA9C4T7R5V8M3K","action":"filing","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:44-06:00","resource":{"id":"100000000009","url":"https://api.satsdk.com/v1/filings/100000000009"},"problem":null}},"filings":{"summary":"Querying the filings: The filings of 2026, queried","value":{"id":"tsk_01JA9C6E8G2H4J6N","action":"filing_query","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:32:10-06:00","startedAt":"2026-10-14T09:32:10-06:00","completedAt":"2026-10-14T09:32:41-06:00","resource":{"id":"fiq_01JA9C6F9H3J5K7P","url":"https://api.satsdk.com/v1/filing-queries/fiq_01JA9C6F9H3J5K7P"},"problem":null}},"acuse":{"summary":"Reading a PDF of a filing: September's acuse, read","value":{"id":"tsk_01JA9C7F9H3J5K7M","action":"filing_document","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:33:40-06:00","startedAt":"2026-10-14T09:33:40-06:00","completedAt":"2026-10-14T09:33:52-06:00","resource":{"id":"fdc_01JA9C7G1J4K6M8Q","url":"https://api.satsdk.com/v1/filing-documents/fdc_01JA9C7G1J4K6M8Q"},"problem":null}},"filingNotFound":{"summary":"Reading a PDF of a filing: An operation number that SAT does not list","value":{"id":"tsk_01JA9C7F9H3J5K7M","action":"filing_document","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:33:40-06:00","startedAt":"2026-10-14T09:33:40-06:00","completedAt":"2026-10-14T09:33:52-06:00","resource":null,"problem":{"type":"https://api.satsdk.com/problems/filing_not_found","title":"Filing not found","status":404,"detail":"SAT lists no filing 100000000099 in 2026.","errors":[{"code":"filing_not_found","message":"SAT lists no filing 100000000099 in 2026."}]}}}}}}},"404":{"description":"No task of yours has this ID.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown ID","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No task of yours has the ID tsk_01JA6Y1K2M8Q4R7V.","errors":[{"code":"not_found","message":"No task of yours has the ID tsk_01JA6Y1K2M8Q4R7V."}]}}}}}},"default":{"$ref":"#/components/responses/Problem"}}}}},"webhooks":{"session.active":{"post":{"operationId":"sessionActive","tags":["Sessions"],"summary":"session.active","description":"SAT logged the session in: tasks queued on it start.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SessionEvent"},{"type":"object","properties":{"type":{"const":"session.active","description":"Always `session.active`."},"data":{"allOf":[{"$ref":"#/components/schemas/Session"},{"type":"object","properties":{"status":{"const":"active","description":"Always `active`."}}}],"description":"The session, `active`."}}}]},"examples":{"signedIn":{"summary":"Signed in","value":{"id":"evt_01JA6X9A2B4C6D8E","type":"session.active","createdAt":"2026-10-14T09:00:48-06:00","data":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"active","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":"2026-10-14T09:15:48-06:00","endedAt":null,"metadata":{}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"session.rejected":{"post":{"operationId":"sessionRejected","tags":["Sessions"],"summary":"session.rejected","description":"SAT refused the login: tasks queued on the session fail with `sign_in_rejected`. It counts against the taxpayer in SAT.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SessionEvent"},{"type":"object","properties":{"type":{"const":"session.rejected","description":"Always `session.rejected`."},"data":{"allOf":[{"$ref":"#/components/schemas/Session"},{"type":"object","properties":{"status":{"const":"rejected","description":"Always `rejected`."}}}],"description":"The session, `rejected`."}}}]},"examples":{"loginRejected":{"summary":"SAT refused the login","value":{"id":"evt_01JA6X9J8K1M3N5P","type":"session.rejected","createdAt":"2026-10-14T09:00:31-06:00","data":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"rejected","closedReason":null,"createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":"2026-10-14T09:00:31-06:00","metadata":{}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"session.closed":{"post":{"operationId":"sessionClosed","tags":["Sessions"],"summary":"session.closed","description":"The session closed. `data.closedReason` gives the cause. Tasks still queued on it fail.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/SessionEvent"},{"type":"object","properties":{"type":{"const":"session.closed","description":"Always `session.closed`."},"data":{"allOf":[{"$ref":"#/components/schemas/Session"},{"type":"object","properties":{"status":{"const":"closed","description":"Always `closed`."}}}],"description":"The session, `closed`."}}}]},"examples":{"idle":{"summary":"Closed after 15 minutes without a task","value":{"id":"evt_01JA9D2Q4R6S8T1V","type":"session.closed","createdAt":"2026-10-14T09:46:44-06:00","data":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"closed","closedReason":"idle","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":null,"endedAt":"2026-10-14T09:46:44-06:00","metadata":{}}}},"signedOut":{"summary":"SAT ended the session","value":{"id":"evt_01JA6Z6W3X5Y7Z9A","type":"session.closed","createdAt":"2026-10-14T09:20:37-06:00","data":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"efirma","status":"closed","closedReason":"signed_out","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":"2026-10-14T09:00:48-06:00","expiresAt":null,"endedAt":"2026-10-14T09:20:37-06:00","metadata":{}}}},"captchaFailed":{"summary":"SAT's captcha was not answered","value":{"id":"evt_01JA6X8M2N4P6Q8R","type":"session.closed","createdAt":"2026-10-14T08:59:58-06:00","data":{"id":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"method":"ciec","status":"closed","closedReason":"captcha_failed","createdAt":"2026-10-14T08:59:50-06:00","signedInAt":null,"expiresAt":null,"endedAt":"2026-10-14T08:59:58-06:00","metadata":{}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"period_options.completed":{"post":{"operationId":"periodOptionsCompleted","tags":["Periods"],"summary":"period_options.completed","description":"Reading the period options completed. Read the `PeriodOptions` at `data.resource.url`, with `GET /period-options/{id}`. The task comes from `loadPeriodOptions`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"period_options.completed","description":"Always `period_options.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"period_options","description":"Always `period_options`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"periodOptions":{"summary":"September's options, read once the session signed in","value":{"id":"evt_01JA6Y0R5T7W9Y2C","type":"period_options.completed","createdAt":"2026-10-14T09:00:58-06:00","data":{"id":"tsk_01JA6Y0R5T7W9Y2B","action":"period_options","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:00:58-06:00","resource":{"id":"pop_01JA6Y0S6V8X1Z3C","url":"https://api.satsdk.com/v1/period-options/pop_01JA6Y0S6V8X1Z3C"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"period_options.failed":{"post":{"operationId":"periodOptionsFailed","tags":["Periods"],"summary":"period_options.failed","description":"Reading the period options failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"period_options.failed","description":"Always `period_options.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"period_options","description":"Always `period_options`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"periodNotOffered":{"summary":"Options for a month that has not started","value":{"id":"evt_01JA6Y0R5T7W9Y2F","type":"period_options.failed","createdAt":"2026-10-14T09:00:58-06:00","data":{"id":"tsk_01JA6Y0R5T7W9Y2B","action":"period_options","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-11","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:00:58-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"prefill.completed":{"post":{"operationId":"prefillCompleted","tags":["Prefills"],"summary":"prefill.completed","description":"Loading the prefill completed. Read the `Prefill` at `data.resource.url`, with `GET /prefills/{prefillSnapshot}`. The task comes from `loadPrefill`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"prefill.completed","description":"Always `prefill.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"prefill","description":"Always `prefill`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"prefill":{"summary":"The prefill, loaded once the session signed in","value":{"id":"evt_01JA6Y1K2M8Q4R7C","type":"prefill.completed","createdAt":"2026-10-14T09:02:11-06:00","data":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:02:11-06:00","resource":{"id":"pfl_292632ec4cbbc2f5","url":"https://api.satsdk.com/v1/prefills/pfl_292632ec4cbbc2f5"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"prefill.failed":{"post":{"operationId":"prefillFailed","tags":["Prefills"],"summary":"prefill.failed","description":"Loading the prefill failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"prefill.failed","description":"Always `prefill.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"prefill","description":"Always `prefill`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"prefillOfDraft":{"summary":"A prefill asked for while SAT holds a draft","value":{"id":"evt_01JA6Y1K2M8Q4R7F","type":"prefill.failed","createdAt":"2026-10-14T09:01:40-06:00","data":{"id":"tsk_01JA6Y1K2M8Q4R7T","action":"prefill","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T08:59:50-06:00","startedAt":"2026-10-14T09:00:48-06:00","completedAt":"2026-10-14T09:01:40-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft.completed":{"post":{"operationId":"draftCompleted","tags":["Drafts"],"summary":"draft.completed","description":"Saving the draft completed. Read the `Draft` at `data.resource.url`, with `GET /drafts/{draftSnapshot}`. The task comes from `saveDraft`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft.completed","description":"Always `draft.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft","description":"Always `draft`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"savedDraft":{"summary":"September's draft, saved and checked by SAT","value":{"id":"evt_01JA6Z5B3N9W2X6C","type":"draft.completed","createdAt":"2026-10-14T09:20:37-06:00","data":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":{"id":"drf_b4008fc2e529a035","url":"https://api.satsdk.com/v1/drafts/drf_b4008fc2e529a035"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft.failed":{"post":{"operationId":"draftFailed","tags":["Drafts"],"summary":"draft.failed","description":"Saving the draft failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft.failed","description":"Always `draft.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft","description":"Always `draft`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"prefillChanged":{"summary":"An expense invoice landed: SAT now preloads 820 of IVA paid","value":{"id":"evt_01JA6Z5B3N9W2X6F","type":"draft.failed","createdAt":"2026-10-14T09:20:37-06:00","data":{"id":"tsk_01JA6Z5B3N9W2X6C","action":"draft","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:19:40-06:00","startedAt":"2026-10-14T09:19:40-06:00","completedAt":"2026-10-14T09:20:37-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_query.completed":{"post":{"operationId":"draftQueryCompleted","tags":["Drafts"],"summary":"draft_query.completed","description":"Querying the draft completed. Read the `DraftQuery` at `data.resource.url`, with `GET /draft-queries/{id}`. The task comes from `queryDraft`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_query.completed","description":"Always `draft_query.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_query","description":"Always `draft_query`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"draftRead":{"summary":"September's draft, queried","value":{"id":"evt_01JA6ZB7K2M4N6PC","type":"draft_query.completed","createdAt":"2026-10-14T09:24:48-06:00","data":{"id":"tsk_01JA6ZB7K2M4N6P8","action":"draft_query","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:24:10-06:00","startedAt":"2026-10-14T09:24:10-06:00","completedAt":"2026-10-14T09:24:48-06:00","resource":{"id":"drq_01JA6ZB8M3N5P7Q9","url":"https://api.satsdk.com/v1/draft-queries/drq_01JA6ZB8M3N5P7Q9"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_query.failed":{"post":{"operationId":"draftQueryFailed","tags":["Drafts"],"summary":"draft_query.failed","description":"Querying the draft failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_query.failed","description":"Always `draft_query.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_query","description":"Always `draft_query`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"draftRead":{"summary":"September's draft, queried, failed","value":{"id":"evt_01JA6ZB7K2M4N6PF","type":"draft_query.failed","createdAt":"2026-10-14T09:24:48-06:00","data":{"id":"tsk_01JA6ZB7K2M4N6P8","action":"draft_query","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:24:10-06:00","startedAt":"2026-10-14T09:24:10-06:00","completedAt":"2026-10-14T09:24:48-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_deletion.completed":{"post":{"operationId":"draftDeletionCompleted","tags":["Drafts"],"summary":"draft_deletion.completed","description":"Deleting the draft completed. The task comes from `deleteDraft`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_deletion.completed","description":"Always `draft_deletion.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_deletion","description":"Always `draft_deletion`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"draftDeleted":{"summary":"The draft that SAT held, deleted","value":{"id":"evt_01JA6Y8D4F6H8J1C","type":"draft_deletion.completed","createdAt":"2026-10-14T09:12:31-06:00","data":{"id":"tsk_01JA6Y8D4F6H8J1K","action":"draft_deletion","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:12:05-06:00","startedAt":"2026-10-14T09:12:05-06:00","completedAt":"2026-10-14T09:12:31-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_deletion.failed":{"post":{"operationId":"draftDeletionFailed","tags":["Drafts"],"summary":"draft_deletion.failed","description":"Deleting the draft failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_deletion.failed","description":"Always `draft_deletion.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_deletion","description":"Always `draft_deletion`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"draftDeleted":{"summary":"The draft that SAT held, deleted, failed","value":{"id":"evt_01JA6Y8D4F6H8J1F","type":"draft_deletion.failed","createdAt":"2026-10-14T09:12:31-06:00","data":{"id":"tsk_01JA6Y8D4F6H8J1K","action":"draft_deletion","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:12:05-06:00","startedAt":"2026-10-14T09:12:05-06:00","completedAt":"2026-10-14T09:12:31-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_filing.completed":{"post":{"operationId":"draftFilingCompleted","tags":["Filings"],"summary":"draft_filing.completed","description":"Filing the draft completed. Read the `Filing` at `data.resource.url`, with `GET /filings/{operationNumber}`. The task comes from `fileDraft`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_filing.completed","description":"Always `draft_filing.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_filing","description":"Always `draft_filing`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"filed":{"summary":"Filed","value":{"id":"evt_01JA9C3S6Q4P7N2C","type":"draft_filing.completed","createdAt":"2026-10-14T09:31:44-06:00","data":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:44-06:00","resource":{"id":"100000000009","url":"https://api.satsdk.com/v1/filings/100000000009"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"draft_filing.failed":{"post":{"operationId":"draftFilingFailed","tags":["Filings"],"summary":"draft_filing.failed","description":"Filing the draft failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"draft_filing.failed","description":"Always `draft_filing.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"draft_filing","description":"Always `draft_filing`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"unconfirmed":{"summary":"SAT received the declaration and gave no acuse","value":{"id":"evt_01JA9C3S6Q4P7N2F","type":"draft_filing.failed","createdAt":"2026-10-14T09:31:40-06:00","data":{"id":"tsk_01JA9C3S6Q4P7N2J","action":"draft_filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:40-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing.completed":{"post":{"operationId":"filingCompleted","tags":["Filings"],"summary":"filing.completed","description":"Filing a declaration completed. Read the `Filing` at `data.resource.url`, with `GET /filings/{operationNumber}`. The task comes from `fileDeclaration`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing.completed","description":"Always `filing.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing","description":"Always `filing`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"filedDirectly":{"summary":"Filed in one task","value":{"id":"evt_01JA9C4T7R5V8M3C","type":"filing.completed","createdAt":"2026-10-14T09:31:44-06:00","data":{"id":"tsk_01JA9C4T7R5V8M3K","action":"filing","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:44-06:00","resource":{"id":"100000000009","url":"https://api.satsdk.com/v1/filings/100000000009"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing.failed":{"post":{"operationId":"filingFailed","tags":["Filings"],"summary":"filing.failed","description":"Filing a declaration failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing.failed","description":"Always `filing.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing","description":"Always `filing`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"filedDirectly":{"summary":"Filed in one task, failed","value":{"id":"evt_01JA9C4T7R5V8M3F","type":"filing.failed","createdAt":"2026-10-14T09:31:44-06:00","data":{"id":"tsk_01JA9C4T7R5V8M3K","action":"filing","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":"2026-09","complementaria":null,"metadata":{"workflowId":"wf_september_XAXX010101000"},"createdAt":"2026-10-14T09:30:58-06:00","startedAt":"2026-10-14T09:30:58-06:00","completedAt":"2026-10-14T09:31:44-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing_query.completed":{"post":{"operationId":"filingQueryCompleted","tags":["Filing queries"],"summary":"filing_query.completed","description":"Querying the filings completed. Read the `FilingQuery` at `data.resource.url`, with `GET /filing-queries/{id}`. The task comes from `queryFilings`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing_query.completed","description":"Always `filing_query.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing_query","description":"Always `filing_query`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"filings":{"summary":"The filings of 2026, queried","value":{"id":"evt_01JA9C6E8G2H4J6C","type":"filing_query.completed","createdAt":"2026-10-14T09:32:41-06:00","data":{"id":"tsk_01JA9C6E8G2H4J6N","action":"filing_query","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:32:10-06:00","startedAt":"2026-10-14T09:32:10-06:00","completedAt":"2026-10-14T09:32:41-06:00","resource":{"id":"fiq_01JA9C6F9H3J5K7P","url":"https://api.satsdk.com/v1/filing-queries/fiq_01JA9C6F9H3J5K7P"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing_query.failed":{"post":{"operationId":"filingQueryFailed","tags":["Filing queries"],"summary":"filing_query.failed","description":"Querying the filings failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing_query.failed","description":"Always `filing_query.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing_query","description":"Always `filing_query`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"filings":{"summary":"The filings of 2026, queried, failed","value":{"id":"evt_01JA9C6E8G2H4J6F","type":"filing_query.failed","createdAt":"2026-10-14T09:32:41-06:00","data":{"id":"tsk_01JA9C6E8G2H4J6N","action":"filing_query","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:32:10-06:00","startedAt":"2026-10-14T09:32:10-06:00","completedAt":"2026-10-14T09:32:41-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing_document.completed":{"post":{"operationId":"filingDocumentCompleted","tags":["Filing queries"],"summary":"filing_document.completed","description":"Reading a PDF of a filing completed. Read the `FilingDocument` at `data.resource.url`, with `GET /filing-documents/{id}`. The task comes from `requestFilingDocument`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing_document.completed","description":"Always `filing_document.completed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing_document","description":"Always `filing_document`."},"status":{"const":"completed","description":"Always `completed`."}}}],"description":"The task, `completed`, without its `problem`."}}}]},"examples":{"acuse":{"summary":"September's acuse, read","value":{"id":"evt_01JA9C7F9H3J5K7C","type":"filing_document.completed","createdAt":"2026-10-14T09:33:52-06:00","data":{"id":"tsk_01JA9C7F9H3J5K7M","action":"filing_document","status":"completed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:33:40-06:00","startedAt":"2026-10-14T09:33:40-06:00","completedAt":"2026-10-14T09:33:52-06:00","resource":{"id":"fdc_01JA9C7G1J4K6M8Q","url":"https://api.satsdk.com/v1/filing-documents/fdc_01JA9C7G1J4K6M8Q"}}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}},"filing_document.failed":{"post":{"operationId":"filingDocumentFailed","tags":["Filing queries"],"summary":"filing_document.failed","description":"Reading a PDF of a filing failed. Get the `problem`, which says why, with `GET /tasks/{id}`.","parameters":[{"$ref":"#/components/parameters/WebhookId"},{"$ref":"#/components/parameters/WebhookTimestamp"},{"$ref":"#/components/parameters/WebhookSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/TaskEvent"},{"type":"object","properties":{"type":{"const":"filing_document.failed","description":"Always `filing_document.failed`."},"data":{"allOf":[{"$ref":"#/components/schemas/TaskSummary"},{"type":"object","properties":{"action":{"const":"filing_document","description":"Always `filing_document`."},"status":{"const":"failed","description":"Always `failed`."}}}],"description":"The task, `failed`, without its `problem`."}}}]},"examples":{"filingNotFound":{"summary":"An operation number that SAT does not list","value":{"id":"evt_01JA9C7F9H3J5K7F","type":"filing_document.failed","createdAt":"2026-10-14T09:33:52-06:00","data":{"id":"tsk_01JA9C7F9H3J5K7M","action":"filing_document","status":"failed","session":"ses_01JA6X7N3K5M7P9R","taxpayer":{"rfc":"XAXX010101000"},"period":null,"complementaria":null,"metadata":{},"createdAt":"2026-10-14T09:33:40-06:00","startedAt":"2026-10-14T09:33:40-06:00","completedAt":"2026-10-14T09:33:52-06:00","resource":null}}}}}}},"responses":{"2XX":{"description":"Acknowledged. Anything else is retried."}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer"}},"parameters":{"WebhookId":{"name":"webhook-id","in":"header","required":true,"description":"The event `id`. The same on every retry of the event, so use it to ignore duplicates.","schema":{"type":"string"}},"WebhookTimestamp":{"name":"webhook-timestamp","in":"header","required":true,"description":"When this delivery was attempted, in seconds since the Unix epoch.","schema":{"type":"integer"}},"WebhookSignature":{"name":"webhook-signature","in":"header","required":true,"description":"Space-separated signatures of `{webhook-id}.{webhook-timestamp}.{body}`, each `v1,` and a base64 HMAC-SHA256.","schema":{"type":"string"}},"SatSession":{"name":"Sat-Session","in":"header","required":true,"description":"ID of the session of the taxpayer. The request acts for that taxpayer. You can send it while the session signs in, and the task waits for the session.","schema":{"type":"string"},"example":"ses_01JA6X7N3K5M7P9R"},"SessionId":{"name":"id","in":"path","required":true,"description":"ID of the session.","schema":{"type":"string"},"example":"ses_01JA6X7N3K5M7P9R"},"TaskId":{"name":"id","in":"path","required":true,"description":"ID of the task.","schema":{"type":"string"},"example":"tsk_01JA6Y1K2M8Q4R7T"},"PeriodOptionsId":{"name":"id","in":"path","required":true,"description":"ID of the period options.","schema":{"type":"string"},"example":"pop_01JA6Y0S6V8X1Z3C"},"PrefillSnapshot":{"name":"prefillSnapshot","in":"path","required":true,"description":"The `prefillSnapshot` of the prefill.","schema":{"type":"string","pattern":"^pfl_[0-9a-f]{16}$"},"example":"pfl_292632ec4cbbc2f5"},"DraftSnapshot":{"name":"draftSnapshot","in":"path","required":true,"description":"The `draftSnapshot` of a draft that your account saved or queried.","schema":{"type":"string","pattern":"^drf_[0-9a-f]{16}$"},"example":"drf_b4008fc2e529a035"},"DraftQueryId":{"name":"id","in":"path","required":true,"description":"ID of the draft query.","schema":{"type":"string"},"example":"drq_01JA6ZB8M3N5P7Q9"},"OperationNumber":{"name":"operationNumber","in":"path","required":true,"description":"Operation number of the filing (*número de operación*).","schema":{"type":"string","pattern":"^\\d{1,20}$"},"example":"100000000009"},"FilingQueryId":{"name":"id","in":"path","required":true,"description":"ID of the filing query.","schema":{"type":"string"},"example":"fiq_01JA9C6F9H3J5K7P"},"FilingDocumentId":{"name":"id","in":"path","required":true,"description":"ID of the filing document.","schema":{"type":"string"},"example":"fdc_01JA9C7G1J4K6M8Q"},"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":true,"description":"Unique key for this request, kept for 24 hours. A retry with the same key and body returns the task of the first request and does not file again, also while that task is waiting or with SAT. If that task failed, nothing was filed, so the retry is a new request. A task that failed with `filing_unconfirmed` is the exception, and the retry returns it.","schema":{"type":"string","maxLength":255},"example":"XAXX010101000-2026-09-1"}},"headers":{},"responses":{"BadRequest":{"description":"The request is malformed: a value has the wrong type or shape, a property is unknown, or a required header is missing.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["invalid_request"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"invalidRequest":{"summary":"An amount sent as text","value":{"type":"https://api.satsdk.com/problems/invalid_request","title":"Invalid request","status":400,"detail":"The body does not match the schema.","errors":[{"code":"invalid_request","path":"declaration.isr.resicoIndividual.income.added","message":"`isr.resicoIndividual.income.added` must be a number, not string."}]}}}}}},"SessionConflict":{"description":"The session is closed, or SAT refused its login: sign in again.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["session_closed"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"closed":{"summary":"The session closed","value":{"type":"https://api.satsdk.com/problems/session_closed","title":"Session closed","status":409,"detail":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again.","errors":[{"code":"session_closed","message":"Session ses_01JA6X7N3K5M7P9R closed at 2026-10-14T09:46:44-06:00. Sign in again."}]}}}}}},"SessionNotFound":{"description":"No session of yours has this ID.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"notFound":{"summary":"Unknown ID","value":{"type":"https://api.satsdk.com/problems/not_found","title":"Not found","status":404,"detail":"No session of yours has the ID ses_01JA6X7N3K5M7P9S.","errors":[{"code":"not_found","message":"No session of yours has the ID ses_01JA6X7N3K5M7P9S."}]}}}}}},"IdempotencyKeyReused":{"description":"The `Idempotency-Key` was used with a different body in the last 24 hours.","content":{"application/problem+json":{"schema":{"type":"object","required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["idempotency_key_reused"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"The `Problem`, with `errors` of these codes."},"examples":{"reused":{"summary":"The key was used with another body","value":{"type":"https://api.satsdk.com/problems/idempotency_key_reused","title":"Idempotency key reused","status":422,"detail":"This Idempotency-Key was used with a different body.","errors":[{"code":"idempotency_key_reused","message":"This Idempotency-Key was used with a different body."}]}}}}}},"Problem":{"description":"Any other error, such as a 401, 403, 429 or 500. The body is the same `Problem` as every error's.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"examples":{"unauthorized":{"summary":"401: an expired token","value":{"type":"https://api.satsdk.com/problems/unauthorized","title":"Unauthorized","status":401,"detail":"The bearer token expired."}},"forbidden":{"summary":"403: a read-only key","value":{"type":"https://api.satsdk.com/problems/forbidden","title":"Forbidden","status":403,"detail":"This API key can only read."}},"rateLimited":{"summary":"429: too many requests","value":{"type":"https://api.satsdk.com/problems/rate_limited","title":"Too many requests","status":429,"detail":"Retry in 30 seconds."}},"serverError":{"summary":"500: something failed on our side","value":{"type":"https://api.satsdk.com/problems/server_error","title":"Server error","status":500,"detail":"An unexpected error happened. It was logged."}}}}},"headers":{"Retry-After":{"description":"Only on a 429: seconds to wait before retrying.","schema":{"type":"integer","minimum":0},"example":30}}}},"schemas":{"DeclarationInput":{"type":"object","additionalProperties":false,"required":["obligations"],"description":"What you declare: the obligations that it files, and your decisions for each one in a block under its tax. A block for an obligation that `obligations` does not list fails with `obligation_not_listed`. If a listed obligation's block is left out, nothing is answered. Preloaded and computed values are read-only. A value behind one of the form's yes/no questions answers it *Sí* when sent, and `false` answers it *No*.","properties":{"obligations":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general"]},"description":"The obligations that the declaration files, by the path of their block. They must be the obligations that the prefill of `prefillSnapshot` loaded."},"isr":{"type":"object","additionalProperties":false,"properties":{"resicoIndividual":{"anyOf":[{"$ref":"#/components/schemas/IsrResicoIndividualInput"},{"type":"null"}],"description":"ISR simplificado de confianza. Personas físicas"},"business":{"anyOf":[{"$ref":"#/components/schemas/IsrBusinessInput"},{"type":"null"}],"description":"ISR personas físicas. Actividad empresarial y profesional"},"companies":{"anyOf":[{"$ref":"#/components/schemas/IsrCompaniesInput"},{"type":"null"}],"description":"ISR personas morales"},"salaryWithholdings":{"anyOf":[{"$ref":"#/components/schemas/IsrSalaryWithholdingsInput"},{"type":"null"}],"description":"ISR retenciones por salarios"},"assimilatedWithholdings":{"anyOf":[{"$ref":"#/components/schemas/IsrAssimilatedWithholdingsInput"},{"type":"null"}],"description":"ISR retenciones por asimilados a salarios"}}},"iva":{"type":"object","additionalProperties":false,"properties":{"resico":{"anyOf":[{"$ref":"#/components/schemas/IvaResicoInput"},{"type":"null"}],"description":"IVA simplificado de confianza"},"general":{"anyOf":[{"$ref":"#/components/schemas/IvaGeneralInput"},{"type":"null"}],"description":"Impuesto al Valor Agregado. Personas morales / Impuesto al Valor Agregado. Personas físicas"}}}}},"ComplementariaType":{"type":"string","enum":["modification"],"description":"`modification` changes the values of a filed declaration (*modificación de obligaciones*). SAT's prefill for it brings what was filed and paid before."},"DeclarationReason":{"type":"string","enum":["fiscalCorrection","taxAudit","deconsolidation","disincorporation","previousScheme"],"description":"What SAT files a declaration under, besides its type: `fiscalCorrection` (*por corrección fiscal*, to correct the taxes during a review by SAT), `taxAudit` (*por dictamen*, after a tax audit by a registered accountant), `deconsolidation` (*por desconsolidación*) and `disincorporation` (*por desincorporación*), when a group of companies leaves tax consolidation or a company leaves the group, and `previousScheme` (*esquema anterior*, a complementaria under the rules before the current kinds)."},"Challenge":{"type":"object","required":["id","value","createdAt","expiresAt"],"description":"SAT's e.firma login challenge, for the e.firma of the taxpayer to sign. It is good for one sign-in.","properties":{"id":{"type":"string","description":"Unique identifier for the challenge. Send it in `challenge` when you sign in.","example":"chl_01JA6X6V2W4Y6Z8B"},"value":{"type":"string","description":"What to sign: `{value}|{rfc}|{certificate serial number}`, with the e.firma's key, RSA PKCS#1 v1.5 with SHA-1."},"createdAt":{"type":"string","format":"date-time","description":"When SAT gave the challenge."},"expiresAt":{"type":"string","format":"date-time","description":"When the challenge expires, 15 minutes after it was given."}}},"EfirmaSignInRequest":{"type":"object","additionalProperties":false,"required":["challenge","certificate","signature"],"description":"The e.firma's signature of a challenge. Neither the e.firma's key nor its password is ever sent.","properties":{"challenge":{"type":"string","description":"ID of the challenge that was signed.","example":"chl_01JA6X6V2W4Y6Z8B"},"certificate":{"type":"string","contentEncoding":"base64","description":"The e.firma's certificate (.cer), base64 of its DER bytes. It is public, and it gives the RFC."},"signature":{"type":"string","contentEncoding":"base64","description":"Base64 of the signature of the challenge's `{value}|{rfc}|{certificate serial number}`, RSA PKCS#1 v1.5 with SHA-1."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"CiecSignInRequest":{"type":"object","additionalProperties":false,"required":["rfc","password"],"description":"The RFC and CIEC of the taxpayer. The API uses the CIEC for this login only and does not keep it.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."},"password":{"type":"string","minLength":1,"maxLength":16,"description":"The CIEC, as the taxpayer types it on SAT's portal."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"Session":{"type":"object","required":["id","taxpayer","method","status","closedReason","createdAt","signedInAt","expiresAt","endedAt","metadata"],"description":"A taxpayer's SAT session, from a sign-in with their e.firma or CIEC. The API keeps it, encrypted, while it is open.","properties":{"id":{"type":"string","description":"Unique identifier for the session. Send it in `Sat-Session`.","example":"ses_01JA6X7N3K5M7P9R"},"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"method":{"type":"string","enum":["efirma","ciec"],"description":"How it signed in."},"status":{"type":"string","enum":["signing_in","active","rejected","closed"],"description":"`signing_in` while SAT logs in, then `active`, or `rejected` when SAT refuses the login. An active session ends `closed`."},"closedReason":{"type":["string","null"],"enum":["requested","idle","signed_out","captcha_failed",null],"description":"Why it closed: you closed it, it went unused until `expiresAt`, SAT ended it, or the API could not answer SAT's captcha for the CIEC. Null unless `closed`."},"createdAt":{"type":"string","format":"date-time","description":"When the sign-in was sent."},"signedInAt":{"type":["string","null"],"format":"date-time","description":"When SAT logged it in. Null until then."},"expiresAt":{"type":["string","null"],"format":"date-time","description":"When it closes unless a task uses it: 15 minutes after it signed in or after its last task. Null unless `active`."},"endedAt":{"type":["string","null"],"format":"date-time","description":"When SAT refused it or it closed. Null until then."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"The `metadata` of the sign-in."}}},"Metadata":{"type":"object","maxProperties":20,"propertyNames":{"maxLength":40},"additionalProperties":{"type":"string","maxLength":500},"description":"Your own key-value pairs, e.g. the ID of the workflow or record a request belongs to: up to 20 keys of 40 characters, with values of up to 500. Never sent to SAT."},"ObligationList":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general"]},"description":"Obligations, by the path of their block in a declaration."},"PeriodOptionsRequest":{"type":"object","additionalProperties":false,"required":["period"],"description":"The month to read the options of.","properties":{"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"PrefillRequest":{"type":"object","additionalProperties":false,"required":["period","obligations"],"description":"The declaration of the period to load the prefill of, and the obligations to load.","properties":{"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"obligations":{"$ref":"#/components/schemas/ObligationList","description":"The obligations to load, by the path of their block. A declaration on this prefill must list the same obligations."},"complementaria":{"$ref":"#/components/schemas/ComplementariaType","description":"Omit it for the normal declaration of the period. Set it for a complementaria of the declaration filed for the period."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"ComputeRequest":{"type":"object","additionalProperties":false,"required":["prefillSnapshot","declaration"],"description":"Every decision of the declaration, and the prefill to compute them on. The prefill says whose declaration it is, for which period and of which type.","properties":{"prefillSnapshot":{"type":"string","pattern":"^pfl_[0-9a-f]{16}$","description":"The `prefillSnapshot` of a prefill your account loaded today, in Mexico City time. Without one, computing fails with `prefill_required`."},"declaration":{"$ref":"#/components/schemas/DeclarationInput"}}},"DraftRequest":{"type":"object","additionalProperties":false,"required":["declaration","prefillSnapshot"],"description":"Every decision of the declaration, and the prefill they were computed on.","properties":{"complementaria":{"$ref":"#/components/schemas/ComplementariaType","description":"Omit it for the normal declaration of the period. Set it for a complementaria of the declaration filed for the period."},"declaration":{"$ref":"#/components/schemas/DeclarationInput"},"prefillSnapshot":{"type":"string","pattern":"^pfl_[0-9a-f]{16}$","description":"The `prefillSnapshot` of the computation that the taxpayer saw. If the prefill changed after it, the task fails with `prefill_changed` and nothing is saved."},"replaceDraft":{"type":"boolean","default":false,"description":"Replace the draft that SAT holds for the period. That draft can be one that someone saved on SAT's portal, so set it only with the approval of the taxpayer."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"DraftQueryRequest":{"type":"object","additionalProperties":false,"required":["period"],"description":"The declaration of the period whose draft to read.","properties":{"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"complementaria":{"$ref":"#/components/schemas/ComplementariaType","description":"Omit it for the normal declaration of the period. Set it for a complementaria of the declaration filed for the period."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"DraftFilingRequest":{"type":"object","additionalProperties":false,"required":["expectedAmountToPay"],"description":"The amount that the taxpayer approved. It carries no decisions: SAT files the draft as it was saved.","properties":{"expectedAmountToPay":{"type":"integer","minimum":0,"description":"Total of the payment reference (*línea de captura*), for all of the obligations of the draft, as the taxpayer approved it. If the draft charges another amount, the task fails with `amount_mismatch` and nothing is filed."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"DirectFilingRequest":{"type":"object","additionalProperties":false,"required":["period","declaration","expectedAmountToPay"],"description":"Every decision of the declaration, and the amount that the taxpayer approved. The task loads the prefill of the listed obligations as of today, and saves the declaration as the draft before SAT checks and files it. If SAT's checks reject it, the saved draft stays. Only the amount protects this filing.","properties":{"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"complementaria":{"$ref":"#/components/schemas/ComplementariaType","description":"Omit it for the normal declaration of the period. Set it for a complementaria of the declaration filed for the period."},"declaration":{"$ref":"#/components/schemas/DeclarationInput"},"expectedAmountToPay":{"type":"integer","minimum":0,"description":"Total of the payment reference (*línea de captura*), for all of the listed obligations, as the taxpayer approved it. If the declaration charges another amount, the task fails with `amount_mismatch` and nothing is filed."},"replaceDraft":{"type":"boolean","default":false,"description":"Delete the draft that SAT holds for the period before the declaration is computed. Without it, if SAT holds a draft, the task fails with `existing_draft` and changes nothing in SAT."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"FilingQueryRequest":{"type":"object","additionalProperties":false,"required":["year"],"description":"Which filings to ask SAT for: those of a year, or of one month of it.","properties":{"year":{"type":"integer","minimum":2016,"description":"Year of the filings (*ejercicio*).","example":2026},"month":{"type":"integer","minimum":1,"maximum":12,"description":"Only the filings of this month. Leave it out for every filing of the year.","example":9},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"FilingDocumentRequest":{"type":"object","additionalProperties":false,"required":["operationNumber","year","kind"],"description":"The filing and which of its PDFs to read.","properties":{"operationNumber":{"type":"string","pattern":"^\\d{1,20}$","description":"Operation number of the filing (*número de operación*).","example":"100000000009"},"year":{"type":"integer","minimum":2016,"description":"Year of the filing (*ejercicio*). SAT finds a filing by its operation number within a year.","example":2026},"kind":{"$ref":"#/components/schemas/FilingDocumentKind"},"metadata":{"$ref":"#/components/schemas/Metadata","description":"Your own key-value pairs, echoed back on what this creates and in its webhooks."}}},"Declaration":{"type":"object","required":["taxpayer","period","type","complementaria","reason","obligations","amountToPay","prefill","engine","issues"],"description":"One month of the obligations of a taxpayer, computed with the rules of the form. It shows what will be declared next to what SAT preloaded, the totals, and what the form still needs. Each obligation that it files is a block under its tax.\n\nA part of a breakdown is present only in these cases:\n\n- The request sent it, or left it out and the declaration wrote it as 0.\n- SAT preloaded a value other than 0 for it, or the form holds one.\n- In a draft read from SAT, it holds 0 and every editable part of the breakdown holds a value.\n- A `missing_value` issue asks for it. Its `declared` is null.","properties":{"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"type":{"type":"string","enum":["normal","complementaria"],"description":"`normal` for the first declaration of the period, `complementaria` for one that amends it."},"complementaria":{"anyOf":[{"$ref":"#/components/schemas/ComplementariaType"},{"type":"null"}],"description":"The kind of complementaria, as requests send it. Null for the normal declaration, and for a complementaria that names no kind."},"reason":{"anyOf":[{"$ref":"#/components/schemas/DeclarationReason"},{"type":"null"}],"description":"What SAT files the declaration under, besides its type. Null for a plain normal or complementaria."},"obligations":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general"]},"description":"The obligations that the declaration files, as the request listed them."},"isr":{"type":"object","additionalProperties":false,"properties":{"resicoIndividual":{"$ref":"#/components/schemas/IsrResicoIndividual"},"business":{"$ref":"#/components/schemas/IsrBusiness"},"companies":{"$ref":"#/components/schemas/IsrCompanies"},"salaryWithholdings":{"$ref":"#/components/schemas/IsrSalaryWithholdings"},"assimilatedWithholdings":{"$ref":"#/components/schemas/IsrAssimilatedWithholdings"}}},"iva":{"type":"object","additionalProperties":false,"properties":{"resico":{"$ref":"#/components/schemas/IvaResico"},"general":{"$ref":"#/components/schemas/IvaGeneral"}}},"amountToPay":{"type":"integer","minimum":0,"description":"Total to pay with this declaration, for all of the obligations that it files: the *total a pagar* of its payment reference."},"ifPaidOn":{"type":"array","items":{"$ref":"#/components/schemas/LatePayment"},"description":"Only when late: what paying on each of the coming dates comes to, since *actualización* and *recargos* grow every day."},"previousFilings":{"type":"array","items":{"$ref":"#/components/schemas/PreviousFiling"},"description":"Only for a complementaria: what was filed and paid before for the period, as SAT has it."},"prefill":{"anyOf":[{"$ref":"#/components/schemas/PrefillState"},{"type":"null"}],"description":"The prefill that the declaration was computed on. Null in a draft read from SAT, which has no prefill."},"engine":{"$ref":"#/components/schemas/Engine"},"issues":{"type":"array","items":{"$ref":"#/components/schemas/Issue"},"description":"What the form still needs before SAT takes the draft, registered obligations that the declaration does not file, and anything else that needs attention. Empty when there is nothing."}}},"Prefill":{"type":"object","required":["taxpayer","period","type","complementaria","reason","prefillSnapshot","fetchedAt","filingOn","dueOn","cutoffs","obligations","declaration","expiresAt"],"description":"What SAT preloaded for the period, as the declaration with nothing answered yet. Its `prefillSnapshot` is its ID.","properties":{"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"type":{"type":"string","enum":["normal","complementaria"],"description":"`normal` for the first declaration of the period, `complementaria` for one that amends it."},"complementaria":{"anyOf":[{"$ref":"#/components/schemas/ComplementariaType"},{"type":"null"}],"description":"The kind of complementaria, as requests send it. Null for the normal declaration, and for a complementaria that names no kind."},"reason":{"anyOf":[{"$ref":"#/components/schemas/DeclarationReason"},{"type":"null"}],"description":"What SAT files the declaration under, besides its type. Null for a plain normal or complementaria."},"prefillSnapshot":{"type":"string","pattern":"^pfl_[0-9a-f]{16}$","description":"Names the prefill: `pfl_` and 16 hexadecimal characters of its hash. Read the prefill with it, and send it to compute and to save the draft."},"fetchedAt":{"type":"string","format":"date-time","description":"When the prefill was read from SAT."},"filingOn":{"type":["string","null"],"format":"date","description":"The day the prefill was loaded, in Mexico City time. SAT computes the declaration as of this day. Compute, save and submit on this day. Null when SAT's prefill does not give it."},"dueOn":{"type":["string","null"],"format":"date","description":"Due date of the declaration. After this day, the declaration is late. Null when SAT's prefill does not give it."},"cutoffs":{"type":"object","additionalProperties":false,"description":"The sources of the prefill and the date each is current to (*fecha de corte*), as SAT lists them. A source shows only if SAT lists it. Its date is null if SAT has none.","properties":{"issuedInvoices":{"type":["string","null"],"format":"date","description":"Income invoices (*facturas de ingresos*). For RESICO, SAT names the invoices issued of type ingreso and egreso, and pago in its second phase."},"payrollInvoices":{"type":["string","null"],"format":"date","description":"Payroll invoices (*facturas de nómina*)."},"provisionalPayments":{"type":["string","null"],"format":"date","description":"Provisional payments (*pagos provisionales*)."},"annualDeclaration":{"type":["string","null"],"format":"date","description":"Prefill of the annual declaration (*declaración anual*)."}}},"obligations":{"type":"array","items":{"$ref":"#/components/schemas/Obligation"},"description":"Every obligation that the taxpayer is registered for in the period. A declaration on this prefill lists exactly the ones with `loaded`."},"previousFilings":{"type":"array","items":{"$ref":"#/components/schemas/PreviousFiling"},"description":"Only for a complementaria: what was filed and paid before for the period, as SAT has it."},"declaration":{"$ref":"#/components/schemas/Declaration","description":"What compute returns for the loaded obligations with no decisions. It shows SAT's values. Each value that the form still needs shows `declared: null` and has a `missing_value` issue."},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"PrefillState":{"type":"object","required":["prefillSnapshot","fetchedAt","filingOn","dueOn","cutoffs"],"description":"The prefill a declaration was computed on.","properties":{"prefillSnapshot":{"type":"string","pattern":"^pfl_[0-9a-f]{16}$","description":"Names the prefill: `pfl_` and 16 hexadecimal characters of its hash. Read the prefill with it, and send it to compute and to save the draft."},"fetchedAt":{"type":"string","format":"date-time","description":"When the prefill was read from SAT."},"filingOn":{"type":["string","null"],"format":"date","description":"The day the prefill was loaded, in Mexico City time. SAT computes the declaration as of this day. Compute, save and submit on this day. Null when SAT's prefill does not give it."},"dueOn":{"type":["string","null"],"format":"date","description":"Due date of the declaration. After this day, the declaration is late. Null when SAT's prefill does not give it."},"cutoffs":{"type":"object","additionalProperties":false,"description":"The sources of the prefill and the date each is current to (*fecha de corte*), as SAT lists them. A source shows only if SAT lists it. Its date is null if SAT has none.","properties":{"issuedInvoices":{"type":["string","null"],"format":"date","description":"Income invoices (*facturas de ingresos*). For RESICO, SAT names the invoices issued of type ingreso and egreso, and pago in its second phase."},"payrollInvoices":{"type":["string","null"],"format":"date","description":"Payroll invoices (*facturas de nómina*)."},"provisionalPayments":{"type":["string","null"],"format":"date","description":"Provisional payments (*pagos provisionales*)."},"annualDeclaration":{"type":["string","null"],"format":"date","description":"Prefill of the annual declaration (*declaración anual*)."}}}}},"Obligation":{"type":"object","required":["code","name","path","supported","filed","loaded"],"description":"An obligation the taxpayer is registered for (SAT's *obligación*).","properties":{"code":{"type":"string","description":"SAT's code for the obligation.","example":"0168"},"name":{"type":"string","description":"SAT's name for the obligation, in Spanish."},"path":{"type":["string","null"],"enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general",null],"description":"Path of its block in the declaration. Null when the API does not map it yet."},"supported":{"type":"boolean","description":"Whether the API maps it. A declaration can list only the obligations that the API maps."},"filed":{"type":"boolean","description":"Whether SAT has a declaration of the obligation filed for the period."},"loaded":{"type":"boolean","description":"Whether this prefill loaded it. A declaration on this prefill lists exactly the loaded obligations."}}},"PeriodOptions":{"type":"object","required":["id","period","normal","complementaria","obligations","expiresAt"],"description":"What SAT offers for the period before you load a prefill: the obligations and the types of declaration.","properties":{"id":{"type":"string","description":"Unique identifier for the period options.","example":"pop_01JA6Y0S6V8X1Z3C"},"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the options are for, as `YYYY-MM`.","example":"2026-09"},"normal":{"type":"boolean","description":"Whether SAT offers the normal declaration of the period."},"complementaria":{"type":"object","required":["modification","withoutEffect","notFiled"],"description":"The types of complementaria that SAT offers for the period. The API files only `modification`.","properties":{"modification":{"type":"boolean","description":"Whether SAT offers a complementaria that changes the values of a filed declaration (*modificación de obligaciones*). It is true when an obligation is `modifiable`."},"withoutEffect":{"type":"boolean","description":"Whether SAT offers a complementaria that cancels a filed obligation (*dejar sin efecto obligación*)."},"notFiled":{"type":"boolean","description":"Whether SAT offers a complementaria for an obligation that the declaration did not file (*obligación no presentada*)."}}},"obligations":{"type":"array","items":{"$ref":"#/components/schemas/PeriodObligation"},"description":"Every obligation that the form of the period can file, in SAT's order."},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"PeriodObligation":{"type":"object","required":["code","name","path","supported","registered","filed","modifiable"],"description":"An obligation that the form of the period can file.","properties":{"code":{"type":"string","description":"SAT's code for the obligation.","example":"0168"},"name":{"type":"string","description":"SAT's name for the obligation, in Spanish."},"path":{"type":["string","null"],"enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general",null],"description":"Path of its block in the declaration. Null when the API does not map it yet."},"supported":{"type":"boolean","description":"Whether the API maps it. A prefill can load only the obligations that the API maps."},"registered":{"type":"boolean","description":"Whether the obligation is in the RFC of the taxpayer for the period. A prefill loads only registered obligations."},"filed":{"type":"boolean","description":"Whether SAT has a declaration of the obligation filed for the period."},"modifiable":{"type":"boolean","description":"Whether a `modification` complementaria can change it. Only filed obligations can be modifiable."}}},"PreviousFiling":{"type":"object","required":["obligation","filedOn","amountToPay","paid","paidOn"],"description":"A declaration filed before for the same period, as SAT has it.","properties":{"obligation":{"type":"string","enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general"],"description":"Path of the block of the obligation it declared."},"filedOn":{"type":["string","null"],"format":"date","description":"When it was filed. Null when SAT's prefill does not show it."},"amountToPay":{"type":["integer","null"],"minimum":0,"description":"What it charged. Null when SAT's prefill does not show it."},"paid":{"type":["integer","null"],"minimum":0,"description":"What SAT has on record as paid. Null when SAT has no payment on record."},"paidOn":{"type":["string","null"],"format":"date","description":"When it was paid. Null when SAT has no payment on record."}}},"LatePayment":{"type":"object","required":["paidOn","amountToPay"],"description":"What a late declaration comes to if paid on a given day.","properties":{"paidOn":{"type":"string","format":"date","description":"Day of the payment."},"amountToPay":{"type":"integer","minimum":0,"description":"Total to pay that day, for all of the listed obligations, with *actualización* and *recargos*."}}},"Engine":{"type":"object","required":["status","formVersion","fingerprint","reasons"],"description":"Whether our evaluation of the form's rules can be trusted for this declaration.","properties":{"status":{"type":"string","enum":["verified","unverified"],"description":"`verified` when this form version was reproduced against SAT. `unverified` for a new form version, or when SAT's *vista previa* disagrees with our totals, until a draft's vista previa matches."},"formVersion":{"type":"string","description":"Form version the engine evaluated."},"fingerprint":{"type":"string","description":"Hash of the taxpayer, the period, the declaration type, the prefill snapshot, the form version, the declared values and the computed totals. Use it to match a saved draft or a filing to the computation that the taxpayer saw."},"reasons":{"type":"array","items":{"type":"string"},"description":"Why the status is not `verified`. Empty when it is."}}},"Draft":{"type":"object","required":["declaration","draftSnapshot","savedAt","checks","expiresAt"],"description":"A draft saved on the portal, with SAT's checks of it. Its `draftSnapshot` is its ID.","properties":{"declaration":{"$ref":"#/components/schemas/Declaration","description":"The declaration as saved. A draft that a query read from SAT does not tell SAT's values from the answers. In it, each `sat` is null and `prefill` is null."},"draftSnapshot":{"type":"string","pattern":"^drf_[0-9a-f]{16}$","description":"Names the draft as SAT stored it: `drf_` and 16 hexadecimal characters of its hash. To file this draft, `POST /drafts/{draftSnapshot}/filings` on the same day."},"savedAt":{"type":["string","null"],"format":"date-time","description":"When SAT saved the draft. Null for a draft that a query read, if SAT does not show the time."},"checks":{"$ref":"#/components/schemas/Checks"},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"DraftQuery":{"type":"object","required":["id","period","complementaria","queriedAt","draft","expiresAt"],"description":"What SAT answered when asked for the draft of a declaration of the period: the draft that it held, or none.","properties":{"id":{"type":"string","description":"Unique identifier for the query.","example":"drq_01JA6ZB8M3N5P7Q9"},"period":{"type":"string","pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the declaration covers, as `YYYY-MM`."},"complementaria":{"anyOf":[{"$ref":"#/components/schemas/ComplementariaType"},{"type":"null"}],"description":"The kind of complementaria, as requests send it. Null for the normal declaration, and for a complementaria that names no kind."},"queriedAt":{"type":"string","format":"date-time","description":"When SAT answered. The answer is what SAT had on record then: ask again for what it has now."},"draft":{"anyOf":[{"$ref":"#/components/schemas/Draft"},{"type":"null"}],"description":"The draft that SAT held, read back. Its checks are `not_run`. Null when SAT held none."},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"Checks":{"type":"object","required":["otis","envio","vistaPrevia"],"description":"The portal's checks on the saved draft.","properties":{"otis":{"$ref":"#/components/schemas/Check"},"envio":{"$ref":"#/components/schemas/Check"},"vistaPrevia":{"type":"object","required":["amountToPay","matches"],"description":"The portal's preview of the declaration (*vista previa*).","properties":{"amountToPay":{"type":["integer","null"],"description":"Total the vista previa shows to pay, for all of the listed obligations. Null when the portal gave no preview."},"matches":{"type":["boolean","null"],"description":"Whether it matches our computed `amountToPay`. Null when the portal gave no preview."}}}}},"Check":{"type":"object","required":["status","messages"],"description":"The result of one check the portal runs on the draft.","properties":{"status":{"type":"string","enum":["passed","failed","not_run"],"description":"Whether the portal accepted the draft. `not_run` when the check did not run, for example after a network error or for a draft that a query read. Submitting the draft runs the checks before SAT files it."},"messages":{"type":"array","items":{"type":"string"},"description":"Messages from the portal, in Spanish. Empty unless the check failed."}}},"Issue":{"type":"object","required":["code","severity","message"],"description":"Something about the declaration that needs attention.","properties":{"code":{"type":"string","enum":["missing_value","sat_rule","unchecked_rule","unlisted_obligation"],"description":"Machine-readable issue code:\n- `missing_value`: the request leaves out a value that the form needs, or that SAT preloaded or suggests. Its `path` is a value that you can send. Ask the taxpayer for it.\n- `sat_rule`: the form's rules reject a value, or replace the one sent. The value can be one that the form sets.\n- `unchecked_rule`: the API cannot run this rule yet, and SAT checks it when the draft is saved. Always a warning.\n- `unlisted_obligation`: the taxpayer is registered for an obligation with no filing for the period, and the declaration does not list it. List it to file it.","example":"missing_value"},"severity":{"type":"string","enum":["info","warning","blocking"],"description":"`blocking` issues keep SAT from taking the draft."},"path":{"type":"string","description":"API path of the value the issue is about, when there is one."},"satField":{"type":"string","description":"SAT field key, as `entity.property`, when the issue is about a field without an API path."},"obligation":{"type":"string","description":"SAT's code of the obligation. Only for `unlisted_obligation`."},"rule":{"type":"string","description":"ID of the SAT rule behind the issue, if there is one."},"sat":{"description":"What SAT preloaded or SAT's form suggests for a value that the request did not send. Show it to the taxpayer, then send it or the value to declare."},"message":{"type":"string","description":"Explanation, in Spanish when it is the form's own message."}}},"Filing":{"type":"object","required":["operationNumber","taxpayer","period","periodicity","type","complementaria","reason","obligations","filedOn","dueOn","inEffect","payment","acusePdfUrl"],"description":"A declaration filed with SAT. Its operation number is its ID. Filing one returns it as SAT acknowledged it in the acuse; querying the filings returns each as SAT has it on record, with its payment and whether a complementaria replaced it.","properties":{"operationNumber":{"type":"string","pattern":"^\\d{1,20}$","description":"SAT's number for the filing (*número de operación*), which identifies it.","example":"100000000009"},"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"period":{"type":"string","pattern":"^(\\d{4}|\\d{4}-(0[1-9]|1[0-2])(/\\d{4}-(0[1-9]|1[0-2]))?)$","description":"The months that it declares: `YYYY-MM` for one month, `YYYY-MM/YYYY-MM` for several (the first and the last), and `YYYY` for the whole year.","example":"2026-09"},"periodicity":{"type":"string","enum":["monthly","bimonthly","quarterly","fourMonthly","semiannual","semiannualLiquidation","adjustment","annual","none"],"description":"How often its obligations are declared (*periodicidad*). It tells periods with the same months apart: a `semiannual` period and a `semiannualLiquidation` one, an `annual` declaration and one with no period (`none`)."},"type":{"type":"string","enum":["normal","complementaria"],"description":"`normal` for the first declaration of the period, `complementaria` for one that amends it."},"complementaria":{"type":["string","null"],"enum":["modification","withoutEffect","notFiled",null],"description":"The kind of complementaria: `modification` (*modificación de obligaciones*), `withoutEffect` (*dejar sin efecto obligación*) or `notFiled` (*obligación no presentada*). Null for a normal declaration, and for a kind of an earlier scheme."},"reason":{"anyOf":[{"$ref":"#/components/schemas/DeclarationReason"},{"type":"null"}],"description":"What SAT files the declaration under, besides its type. Null for a plain normal or complementaria."},"obligations":{"type":"array","items":{"type":"string","enum":["isr.resicoIndividual","isr.business","isr.companies","isr.salaryWithholdings","isr.assimilatedWithholdings","iva.resico","iva.general"]},"description":"The obligations that it declared, by the path of their block."},"filedOn":{"type":["string","null"],"format":"date","description":"The day SAT received it. Null when SAT does not show it."},"dueOn":{"type":["string","null"],"format":"date","description":"Due date of the declaration. Null when SAT does not show it."},"inEffect":{"type":"boolean","description":"Whether SAT has the filing in effect (*vigente*). False when a later complementaria replaced it (*anulada*)."},"payment":{"anyOf":[{"$ref":"#/components/schemas/FilingPayment"},{"type":"null"}],"description":"Its payment reference, and whether SAT identified its payment. Null when it had nothing to pay."},"acusePdfUrl":{"type":["string","null"],"format":"uri","description":"Link to the acuse, the filing receipt. It works until the `expiresAt` of what returned it. Null when the API did not read the acuse: request it as a filing document."}}},"FilingPayment":{"type":"object","required":["reference","amountToPay","referenceExpiresOn","paid"],"description":"What a filing charged, and whether SAT identified its payment.","properties":{"reference":{"type":"string","description":"The payment reference (*línea de captura*)."},"amountToPay":{"type":["integer","null"],"minimum":0,"description":"Total of the payment reference, for all of the obligations that it declared, from the acuse. After `referenceExpiresOn`, the taxpayer owes more because of *actualización* and *recargos*. Null when the API did not read the acuse: a query reads it only for a filing in effect that SAT has no payment of."},"referenceExpiresOn":{"type":["string","null"],"format":"date","description":"Last day to pay `amountToPay` with `reference`. Null when `amountToPay` is null."},"paid":{"type":"boolean","description":"Whether SAT identified a payment of the filing. A payment shows only after SAT identifies it."}}},"FilingQuery":{"type":"object","required":["id","year","month","queriedAt","filings","expiresAt"],"description":"What SAT answered when asked for the filings of a year, or of one month of it: what it had on record then.","properties":{"id":{"type":"string","description":"Unique identifier for the query.","example":"fiq_01JA9C6F9H3J5K7P"},"year":{"type":"integer","minimum":2016,"description":"Year of the filings (*ejercicio*)."},"month":{"type":["integer","null"],"minimum":1,"maximum":12,"description":"The month that was asked for. Null for the whole year."},"queriedAt":{"type":"string","format":"date-time","description":"When SAT answered. The answer is what SAT had on record then: ask again for what it has now."},"filings":{"type":"array","items":{"$ref":"#/components/schemas/Filing"},"description":"Every filing, the latest filed first. It includes the filings that a complementaria replaced."},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"FilingDocumentKind":{"type":"string","enum":["declaration","acuse","payment"],"description":"Which PDF: `declaration` (every value of the declaration as filed), `acuse` (the filing receipt, with the amount to pay) or `payment` (the payment that SAT identified, with its bank)."},"FilingDocument":{"type":"object","required":["id","operationNumber","kind","pdfUrl","text","expiresAt"],"description":"A PDF that SAT keeps of a filing, and its text.","properties":{"id":{"type":"string","description":"Unique identifier for the document.","example":"fdc_01JA9C7G1J4K6M8Q"},"operationNumber":{"type":"string","pattern":"^\\d{1,20}$","description":"Operation number of the filing.","example":"100000000009"},"kind":{"$ref":"#/components/schemas/FilingDocumentKind"},"pdfUrl":{"type":"string","format":"uri","description":"Link to the PDF. It works until `expiresAt`."},"text":{"type":"string","description":"The text of the PDF, page after page: SAT's labels and values in Spanish, without the layout."},"expiresAt":{"type":"string","format":"date-time","description":"When the API discards it, 48 hours after SAT answered. After that, reading it returns 404."}}},"TaskResource":{"type":"object","required":["id","url"],"description":"What a task brought back from SAT, kept for reading with a `GET`.","properties":{"id":{"type":"string","description":"Its ID: the `prefillSnapshot` of a prefill, the `draftSnapshot` of a draft, the operation number of a filing, or the `id` of anything else."},"url":{"type":"string","format":"uri","description":"Where to read it."}}},"TaskSummary":{"type":"object","required":["id","action","status","session","taxpayer","period","complementaria","metadata","createdAt","startedAt","completedAt","resource"],"description":"A task without its `problem`, as webhooks post it. `GET /tasks/{id}` returns the whole task.","properties":{"id":{"type":"string","description":"Unique identifier for the task.","example":"tsk_01JA6Y1K2M8Q4R7T"},"action":{"type":"string","enum":["period_options","prefill","draft","draft_query","draft_deletion","draft_filing","filing","filing_query","filing_document"],"description":"What was asked: reading the period options, loading the prefill, saving the draft, querying the draft, deleting the draft, filing the draft, filing a declaration, querying the filings, or reading the PDF of a filing."},"status":{"type":"string","enum":["queued","running","completed","failed"],"description":"`queued` while the session signs in or runs another task, `running` while SAT works on it, then `completed` or `failed`."},"session":{"type":"string","description":"ID of the session it runs in.","example":"ses_01JA6X7N3K5M7P9R"},"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"period":{"type":["string","null"],"pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the task acts on, as `YYYY-MM`. Null when it queries the filings or reads the PDF of a filing."},"complementaria":{"anyOf":[{"$ref":"#/components/schemas/ComplementariaType"},{"type":"null"}],"description":"The kind of complementaria, as requests send it. Null for the normal declaration, and for a complementaria that names no kind."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"The `metadata` of the request that created it. Empty for a deletion."},"createdAt":{"type":"string","format":"date-time","description":"When the task was created."},"startedAt":{"type":["string","null"],"format":"date-time","description":"When it reached SAT. Null while `queued`, and when it failed before reaching SAT."},"completedAt":{"type":["string","null"],"format":"date-time","description":"When SAT finished, or when the task failed. Null until then."},"resource":{"anyOf":[{"$ref":"#/components/schemas/TaskResource"},{"type":"null"}],"description":"What the task brought back. Null until it completes, and for a deletion."}}},"Task":{"type":"object","required":["id","action","status","session","taxpayer","period","complementaria","metadata","createdAt","startedAt","completedAt","resource","problem"],"description":"Work that reaches SAT, in the taxpayer's session. It says where the work is. Once it completes, `resource` links to what it brought back. Once it fails, `problem` says why.","properties":{"id":{"type":"string","description":"Unique identifier for the task.","example":"tsk_01JA6Y1K2M8Q4R7T"},"action":{"type":"string","enum":["period_options","prefill","draft","draft_query","draft_deletion","draft_filing","filing","filing_query","filing_document"],"description":"What was asked: reading the period options, loading the prefill, saving the draft, querying the draft, deleting the draft, filing the draft, filing a declaration, querying the filings, or reading the PDF of a filing."},"status":{"type":"string","enum":["queued","running","completed","failed"],"description":"`queued` while the session signs in or runs another task, `running` while SAT works on it, then `completed` or `failed`."},"session":{"type":"string","description":"ID of the session it runs in.","example":"ses_01JA6X7N3K5M7P9R"},"taxpayer":{"type":"object","required":["rfc"],"description":"The taxpayer filing.","properties":{"rfc":{"type":"string","pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC of the taxpayer."}}},"period":{"type":["string","null"],"pattern":"^\\d{4}-(0[1-9]|1[0-2])$","description":"Month the task acts on, as `YYYY-MM`. Null when it queries the filings or reads the PDF of a filing."},"complementaria":{"anyOf":[{"$ref":"#/components/schemas/ComplementariaType"},{"type":"null"}],"description":"The kind of complementaria, as requests send it. Null for the normal declaration, and for a complementaria that names no kind."},"metadata":{"$ref":"#/components/schemas/Metadata","description":"The `metadata` of the request that created it. Empty for a deletion."},"createdAt":{"type":"string","format":"date-time","description":"When the task was created."},"startedAt":{"type":["string","null"],"format":"date-time","description":"When it reached SAT. Null while `queued`, and when it failed before reaching SAT."},"completedAt":{"type":["string","null"],"format":"date-time","description":"When SAT finished, or when the task failed. Null until then."},"resource":{"anyOf":[{"$ref":"#/components/schemas/TaskResource"},{"type":"null"}],"description":"What the task brought back. Null until it completes, and for a deletion."},"problem":{"type":["object","null"],"required":["type","title","status","detail","errors"],"properties":{"type":{"type":"string","format":"uri"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"errors":{"type":"array","minItems":1,"description":"Each problem found: an `Error`, its `code` one of these.","items":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["sign_in_rejected","signed_out","sat_unavailable","not_offered","existing_draft","obligation_not_registered","unsupported_form","prefill_changed","obligations_mismatch","sat_rule","obligation_not_listed","not_applicable","set_by_form","authorized_coefficient_mismatch","draft_not_found","draft_changed","draft_expired","amount_mismatch","filing_unconfirmed","filing_not_found"]},"message":{"type":"string"},"path":{"type":"string"},"rule":{"type":"string"},"satField":{"type":"string"},"obligation":{"type":"string"},"expected":{"type":["string","number"]},"actual":{"type":["string","number"]},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"}}}}}},"description":"Why the task failed. Null unless `failed`."}}},"SessionEvent":{"type":"object","required":["id","type","createdAt","data"],"description":"An event about a session. It carries the session, as `GET /sessions/{id}` returns it.","properties":{"id":{"type":"string","description":"Unique identifier for the event. Also sent as the `webhook-id` header."},"type":{"type":"string","enum":["session.active","session.rejected","session.closed"],"description":"What happened: the session and the `status` it reached, or the task's `action` and the `status` it ended in."},"createdAt":{"type":"string","format":"date-time","description":"When it happened."},"data":{"$ref":"#/components/schemas/Session","description":"The session, as `GET /sessions/{id}` returns it."}}},"TaskEvent":{"type":"object","required":["id","type","createdAt","data"],"description":"An event about a task. It carries no figures from SAT: read them at `data.resource.url`, or the `problem` with `GET /tasks/{id}`.","properties":{"id":{"type":"string","description":"Unique identifier for the event. Also sent as the `webhook-id` header."},"type":{"type":"string","enum":["period_options.completed","period_options.failed","prefill.completed","prefill.failed","draft.completed","draft.failed","draft_query.completed","draft_query.failed","draft_deletion.completed","draft_deletion.failed","draft_filing.completed","draft_filing.failed","filing.completed","filing.failed","filing_query.completed","filing_query.failed","filing_document.completed","filing_document.failed"],"description":"What happened: the session and the `status` it reached, or the task's `action` and the `status` it ended in."},"createdAt":{"type":"string","format":"date-time","description":"When it happened."},"data":{"$ref":"#/components/schemas/TaskSummary","description":"The task, without its `problem`."}}},"WebhookEvent":{"oneOf":[{"$ref":"#/components/schemas/SessionEvent"},{"$ref":"#/components/schemas/TaskEvent"}],"discriminator":{"propertyName":"type","mapping":{"session.active":"#/components/schemas/SessionEvent","session.rejected":"#/components/schemas/SessionEvent","session.closed":"#/components/schemas/SessionEvent","period_options.completed":"#/components/schemas/TaskEvent","period_options.failed":"#/components/schemas/TaskEvent","prefill.completed":"#/components/schemas/TaskEvent","prefill.failed":"#/components/schemas/TaskEvent","draft.completed":"#/components/schemas/TaskEvent","draft.failed":"#/components/schemas/TaskEvent","draft_query.completed":"#/components/schemas/TaskEvent","draft_query.failed":"#/components/schemas/TaskEvent","draft_deletion.completed":"#/components/schemas/TaskEvent","draft_deletion.failed":"#/components/schemas/TaskEvent","draft_filing.completed":"#/components/schemas/TaskEvent","draft_filing.failed":"#/components/schemas/TaskEvent","filing.completed":"#/components/schemas/TaskEvent","filing.failed":"#/components/schemas/TaskEvent","filing_query.completed":"#/components/schemas/TaskEvent","filing_query.failed":"#/components/schemas/TaskEvent","filing_document.completed":"#/components/schemas/TaskEvent","filing_document.failed":"#/components/schemas/TaskEvent"}},"description":"Posted to your webhook endpoint when a session or a task changes. `type` gives what happened."},"PrefillChange":{"type":"object","required":["path","satField","label","before","after"],"description":"One value that changed in the prefill.","properties":{"path":{"type":["string","null"],"description":"API path of the value. Null when the API does not map the field."},"satField":{"type":"string","description":"SAT field key, as `entity.property`."},"label":{"type":"string","description":"The field's label on the form, in Spanish."},"before":{"type":["integer","string","null"],"description":"Value in the prefill you sent: an amount, or a string for dates and text. Null when the field was empty."},"after":{"type":["integer","string","null"],"description":"Value in SAT's current prefill: an amount, or a string for dates and text. Null when the field is now empty."}}},"Error":{"type":"object","required":["code","message"],"description":"One problem with a request or a task. Each error response and each task narrows `code` to the codes it carries.","properties":{"code":{"type":"string","enum":["invalid_request","not_found","filing_not_found","prefill_required","prefill_changed","obligations_mismatch","existing_draft","draft_not_found","draft_changed","draft_expired","amount_mismatch","filing_in_progress","session_closed","signed_out","challenge_expired","sign_in_cooldown","sat_rule","invalid_signature","sign_in_rejected","unsupported_form","obligation_not_listed","obligation_not_registered","not_applicable","set_by_form","authorized_coefficient_mismatch","not_offered","idempotency_key_reused","filing_unconfirmed","sat_unavailable"],"description":"Machine-readable error code. The problem's `type` ends with the code of its first error.\n\n- `invalid_request` (400): The body, a parameter or a header does not match the schema.\n- `not_found` (404): No session, task or resource of your account has this ID, or what a task brought back is over 48 hours old.\n- `filing_not_found` (404): SAT lists no filing with this operation number in `year`. For the `payment`, SAT identified no payment of the filing.\n- `prefill_required` (409): No prefill with this `prefillSnapshot` was loaded today. Load the prefill again.\n- `prefill_changed` (409): The prefill changed after `prefillSnapshot`, or is of an earlier day. Load it again and compute on it.\n- `obligations_mismatch` (409): The declaration lists other obligations than the prefill of `prefillSnapshot` loaded.\n- `existing_draft` (409): SAT holds a draft for the period. Query it with `POST /draft-queries`, then file it or delete it.\n- `draft_not_found` (409): SAT holds no draft of this type for the period. Nothing was filed or deleted.\n- `draft_changed` (409): SAT holds another draft than the one of `draftSnapshot`. Nothing was filed or deleted. Query the new draft.\n- `draft_expired` (409): The draft was saved on an earlier day. Nothing was filed. Delete it, load the prefill and save again.\n- `amount_mismatch` (409): The declaration or the draft charges another amount than `expectedAmountToPay`. `actual` is that amount. Ask the taxpayer to approve it.\n- `filing_in_progress` (409): Another filing of the declaration, named in `message`, is queued or with SAT. When it ends, file again only if it filed nothing.\n- `session_closed` (409): The session is closed, or SAT refused its login. Nothing reached SAT. Sign in again.\n- `signed_out` (409): SAT ended the session during the task, and nothing was done in SAT. Sign in again and retry.\n- `challenge_expired` (409): The challenge expired, or a sign-in already used it. Get a new one.\n- `sign_in_cooldown` (409): SAT refused a login for the RFC recently. `detail` gives the time when you can sign in again.\n- `sat_rule` (422): A rule of the form, or a SAT check, rejects a value. `message` says why.\n- `invalid_signature` (422): The certificate is not a valid e.firma, or the signature is not of the challenge. Nothing reached SAT.\n- `sign_in_rejected` (422): SAT refused the login, so the task did not run. Make sure that the e.firma or the CIEC is correct before you sign in again.\n- `unsupported_form` (422): The API does not yet support a rule, an obligation (`obligation`) or a value (`path`, `satField`) of this form version.\n- `obligation_not_listed` (422): A block is for an obligation that `obligations` does not list. List it, or remove the block.\n- `obligation_not_registered` (422): `obligations` lists an obligation that the taxpayer is not registered for in the period.\n- `not_applicable` (422): The value is only for another kind of taxpayer. Leave it out.\n- `set_by_form` (422): SAT's form sets this value in this declaration. Leave it out, or send `actual` if the value is editable.\n- `authorized_coefficient_mismatch` (422): SAT has another coefficient for the authorization number and date in the declaration.\n- `not_offered` (422): SAT does not offer this declaration, for example a complementaria for a period with nothing filed.\n- `idempotency_key_reused` (422): The `Idempotency-Key` came with a different body before. Use a new key for a new request.\n- `filing_unconfirmed` (502): SAT received the declaration but gave no acuse. Query the filings of the period to know whether SAT filed it, before you file again.\n- `sat_unavailable` (503): SAT did not respond, or it responded with an error. Retry later."},"message":{"type":"string","description":"Human-readable explanation. For `sat_rule`, the form's or SAT's message verbatim, in Spanish."},"path":{"type":"string","description":"API path of the offending value."},"rule":{"type":"string","description":"ID of the SAT rule that failed. Only for `sat_rule`."},"satField":{"type":"string","description":"SAT field key, as `entity.property`."},"obligation":{"type":"string","description":"SAT's code of the obligation. Only for `obligation_not_registered` and `unsupported_form`."},"expected":{"type":["string","number"],"description":"What you sent: a prefill snapshot, an amount or a value. Only for 409 and `set_by_form`."},"actual":{"type":["string","number"],"description":"What SAT has now, or what SAT's form holds for the value. Only for 409 and `set_by_form`."},"changes":{"type":"array","items":{"$ref":"#/components/schemas/PrefillChange"},"description":"What changed in the prefill after the snapshot that you sent. Only for `prefill_changed`."}}},"Problem":{"type":"object","required":["type","title","status","detail"],"description":"Body of every error response, and the `problem` of a failed task: a problem details object (RFC 9457), served as `application/problem+json`. An operation's own error responses and a task's `problem` add `errors`, with the codes they carry. A 401, 403, 405, 413, 429 or 500 carries none.","properties":{"type":{"type":"string","format":"uri","description":"URI that names the kind of problem: `{origin}/problems/{code}`, where `code` is the first of its `errors`, or `unauthorized`, `forbidden`, `method_not_allowed`, `payload_too_large`, `rate_limited` or `server_error`."},"title":{"type":"string","description":"Short summary of the kind of problem. The same for every problem of a `type`."},"status":{"type":"integer","description":"HTTP status code of the response. For a failed task, the status code that a response with this problem has."},"detail":{"type":"string","description":"Explanation of this occurrence of the problem."}}},"DeclaredAmount":{"type":"object","required":["sat","declared","source","editable"],"description":"A declared amount next to what SAT preloaded for it, and whether a request can send it.","properties":{"sat":{"type":["integer","null"],"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["integer","null"],"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"ValueSource":{"type":"string","enum":["sat","caller"],"description":"`caller` when you sent the value, left out a part that the declaration writes as 0, or must still send it. `sat` when the value is read-only, set by the form's rules, or preloaded and not sent. In a draft read from SAT, `caller` marks the editable values and `sat` the read-only ones."},"IsrResicoIndividualIncomeInput":{"type":"object","additionalProperties":false,"properties":{"discounts":{"type":"object","additionalProperties":false,"properties":{"coOwnership":{"description":"Descuentos, devoluciones y bonificaciones de integrantes por copropiedad","type":["integer","null"],"minimum":0}}},"added":{"description":"Importe\n\nAnswers *¿Tienes ingresos adicionales?*.","anyOf":[{"type":"integer","exclusiveMinimum":0},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"subtractions":{"description":"¿Tienes ingresos a disminuir?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsNotSeparated":{"type":["integer","null"],"exclusiveMinimum":0,"title":"IEPS cobrado no trasladado de manera expresa y por separado","description":"IEPS cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"accruedInEarlierPeriods":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados acumulados en periodos anteriores","description":"Ingresos facturados acumulados en periodos anteriores"},"governmentSupport":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Apoyos gubernamentales","description":"Apoyos gubernamentales"},"onBehalfOfThirdParties":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"byActivity":{"description":"Detalle de Total de ingresos percibidos por la actividad","type":["object","null"],"additionalProperties":false,"minProperties":1,"properties":{"businessActivity":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Actividad empresarial","description":"Actividad empresarial"},"professionalServices":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Servicios profesionales (Honorarios)","description":"Servicios profesionales (Honorarios)"},"primarySector":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Actividades agrícolas, ganaderas, silvícolas o pesqueras","description":"Actividades agrícolas, ganaderas, silvícolas o pesqueras"},"fixedAssetSales":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad","description":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad"},"leasing":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Uso o goce temporal de bienes","description":"Uso o goce temporal de bienes"}}},"coOwnership":{"description":"¿Los ingresos fueron obtenidos a través de copropiedad?\n\nThe API cannot declare its rows yet: a row fails with `unsupported_form`, so only `false` (*No*) can be sent.","anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}},"minItems":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]}},"x-scalar-ignore":true},"IsrResicoIndividualWithheldInput":{"type":"object","additionalProperties":false,"properties":{"added":{"description":"ISR retenido a adicionar","type":["integer","null"],"minimum":0},"subtracted":{"description":"ISR retenido no acreditable","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IsrResicoIndividualPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesInput"},"offsets":{"$ref":"#/components/schemas/OffsetsInput"},"incentives":{"description":"¿Tienes estímulos por aplicar?\n\nSAT's form offers no concept for it in this declaration, so a request can only answer *No*, with `false`.","anyOf":[{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/InstallmentsInput"}},"x-scalar-ignore":true},"IsrResicoIndividualInput":{"type":"object","additionalProperties":false,"description":"ISR simplificado de confianza. Personas físicas","properties":{"income":{"$ref":"#/components/schemas/IsrResicoIndividualIncomeInput"},"withheld":{"$ref":"#/components/schemas/IsrResicoIndividualWithheldInput"},"priorPayments":{"description":"Detalle Pagos efectuados con anterioridad","type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["regime","year","periodicity","period","operationNumber","amount"],"properties":{"regime":{"type":"string","oneOf":[{"const":"R2","title":"Actividad Empresarial y Servicios Profesionales"},{"const":"R3","title":"Arrendamiento"},{"const":"R4","title":"Ambos"}],"description":"Régimen fiscal"},"year":{"type":"string","oneOf":[{"const":"2026","title":"2026"},{"const":"2025","title":"2025"},{"const":"2024","title":"2024"},{"const":"2023","title":"2023"},{"const":"2022","title":"2022"}],"description":"Ejercicio"},"periodicity":{"type":"string","oneOf":[{"const":"PD2","title":"Mensual"},{"const":"PD3","title":"Trimestral"},{"const":"PD4","title":"Del ejercicio"}],"description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodoPPRESICOPF","description":"Periodo"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Pagos a disminuir"}}}},"payment":{"$ref":"#/components/schemas/IsrResicoIndividualPaymentInput"}},"x-scalar-ignore":true},"IsrBusinessIncomeInput":{"type":"object","additionalProperties":false,"properties":{"subtractions":{"description":"¿Tienes ingresos a disminuir del mes?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado"},"accruedInEarlierPeriods":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"invoicedWithGainOnSale":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"pendingCancellation":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithExchangeGain":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"},"visualArtists":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos de personas físicas dedicadas a las artes plásticas","description":"Ingresos de personas físicas dedicadas a las artes plásticas"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"added":{"description":"¿Tienes ingresos adicionales del mes?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"debtRelief":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Condonaciones, quitas o remisiones","description":"Condonaciones, quitas o remisiones"},"thirdPartyExpenses":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Gastos por cuenta de terceros sin comprobante fiscal","description":"Gastos por cuenta de terceros sin comprobante fiscal"},"interest":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales","description":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales"},"gainOnSales":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia por enajenación de activos","description":"Ganancia por enajenación de activos"},"exchangeGains":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"},"freightCoordinated":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)","description":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)"},"invoicedNotPrefilled":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados no considerados en el prellenado","description":"Ingresos facturados no considerados en el prellenado"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"exempt":{"description":"Ingresos exentos del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"coOwnership":{"description":"¿Tus ingresos fueron obtenidos en copropiedad o sociedad conyugal?\n\nThe API cannot declare its rows yet: a row fails with `unsupported_form`, so only `false` (*No*) can be sent.","anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}},"minItems":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]}},"x-scalar-ignore":true},"IsrBusinessDeductionsInput":{"type":"object","additionalProperties":false,"properties":{"payroll":{"description":"Gastos de nómina del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"purchases":{"type":["object","null"],"additionalProperties":false,"properties":{"notDeductible":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Compras y gastos no deducibles del mes"},"notPrefilled":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Compras y gastos del mes no considerados en el pre llenado"},"creditNotesReceived":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Facturas de egresos recibidas por compras y gastos del mes"}}},"investments":{"description":"Deducción de inversiones del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"immediateDeduction":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Detalle de Deducción inmediata de inversiones Decreto Relocalización › Deducción inmediata de inversiones del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"planMexico":{"description":"Detalle de Deducción inmediata de inversiones Decreto Plan Mexico › Deducción inmediata de inversiones del mes","type":["integer","null"],"minimum":0}}},"incentives":{"description":"¿Tienes facilidades administrativas y estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"olderWorkers":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por contratar adultos mayores (25% del salario pagado)","description":"Estímulo por contratar adultos mayores (25% del salario pagado)"},"workersWithDisabilities":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad","description":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad"},"booksAndPress":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción adicional por enajenación de libros, periódicos y revistas","description":"Deducción adicional por enajenación de libros, periódicos y revistas"},"freightUndocumented":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte","description":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte"},"landForDevelopment":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios","description":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios"},"donationsToAgencies":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal.","description":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal."}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]}},"x-scalar-ignore":true},"IsrBusinessProfitSharingInput":{"type":"object","additionalProperties":false,"properties":{"applied":{"description":"PTU acumulada a aplicar en el periodo","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IsrBusinessUndocumentedDeductionInput":{"type":"object","additionalProperties":false,"properties":{"creditedIncentives":{"description":"Estímulos acreditables","type":["integer","null"],"minimum":0},"creditedIncentivesByConcept":{"description":"Detalle de Estímulos acreditables","type":["object","null"],"additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":["integer","null"],"maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}}},"priorPayments":{"description":"Pagos provisionales de periodos anteriores","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IsrBusinessPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesInput"},"offsets":{"$ref":"#/components/schemas/OffsetsInput"},"employmentSubsidy":{"description":"Subsidio para el empleo","type":["integer","null"],"minimum":0,"maximum":99999999999999},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/InstallmentsInput"}},"x-scalar-ignore":true},"IsrBusinessInput":{"type":"object","additionalProperties":false,"description":"ISR personas físicas. Actividad empresarial y profesional","properties":{"income":{"$ref":"#/components/schemas/IsrBusinessIncomeInput"},"deductions":{"$ref":"#/components/schemas/IsrBusinessDeductionsInput"},"profitSharing":{"$ref":"#/components/schemas/IsrBusinessProfitSharingInput"},"losses":{"type":["object","null"],"additionalProperties":false,"properties":{"available":{"type":["integer","null"],"minimum":0,"description":"Pérdida de ejercicios anteriores aplicables"},"applied":{"type":["integer","null"],"minimum":0,"description":"Pérdida actualizada por aplicar en el periodo"}}},"taxIncentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":["object","null"],"additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"priorPayments":{"description":"Pagos provisionales efectuados con anterioridad","type":["integer","null"],"minimum":0},"resicoPayments":{"description":"Detalle Pagos provisionales efectuados en el Régimen Simplificado de Confianza","type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["month","operationNumber","amount"],"properties":{"month":{"$ref":"#/components/schemas/SatCatalogMeses","description":"Mes"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto pagado"}}}},"withheld":{"description":"ISR retenido del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"undocumentedDeduction":{"$ref":"#/components/schemas/IsrBusinessUndocumentedDeductionInput"},"payment":{"$ref":"#/components/schemas/IsrBusinessPaymentInput"}},"x-scalar-ignore":true},"IsrCompaniesIncomeInput":{"type":"object","additionalProperties":false,"properties":{"added":{"description":"¿Tienes ingresos nominales adicionales?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"gainOnSales":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ganancia por enajenación","description":"Ganancia por enajenación"},"invoicedEarlierCollectedNow":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignIncome":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos del extranjero","description":"Ingresos del extranjero"},"accruedWithoutInvoice":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación","description":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación"},"interest":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Intereses (Artículo 8 LISR)","description":"Intereses (Artículo 8 LISR)"},"debtNotPaid":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos derivados de deuda no cubierta","description":"Ingresos derivados de deuda no cubierta"},"exchangeGains":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"subtractions":{"description":"¿Tienes ingresos nominales a disminuir?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":["integer","null"],"exclusiveMinimum":0,"title":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithGainOnSale":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"invoicedNotCollected":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignWithheld":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos del extranjero sujetos a retención o pago de impuesto","description":"Ingresos del extranjero sujetos a retención o pago de impuesto"},"accruedInEarlierPeriods":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"onBehalfOfThirdParties":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"},"accruedOnCollection":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Por acumulación del cobro total o parcial del precio en el ejercicio","description":"Por acumulación del cobro total o parcial del precio en el ejercicio"},"foreignPensionFunds":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero","description":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero"},"invoicedWithExchangeGain":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"borderRegion":{"type":"object","additionalProperties":false,"properties":{"north":{"description":"Ingresos nominales exclusivos dentro de la región fronteriza norte","type":["integer","null"],"minimum":0,"maximum":99999999999999},"south":{"description":"Ingresos nominales exclusivos dentro de la región fronteriza sur","type":["integer","null"],"minimum":0,"maximum":99999999999999},"notSubject":{"description":"Ingresos nominales no sujetos al estímulo de la región fronteriza","type":["integer","null"],"minimum":0,"maximum":99999999999999}}}},"x-scalar-ignore":true},"IsrCompaniesImmediateDeductionInput":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Total Detalle de Deducción inmediata de inversiones Relocalización › Deducción inmediata de inversiones del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"planSonora":{"description":"Total Detalle de Deducción inmediata de inversiones Plan Sonora › Deducción inmediata de inversiones del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999},"planMexico":{"description":"Total Detalle de Deducción inmediata de inversiones Plan México › Deducción inmediata de inversiones del mes","type":["integer","null"],"minimum":0,"maximum":99999999999999}},"x-scalar-ignore":true},"IsrCompaniesProfitSharingInput":{"type":"object","additionalProperties":false,"properties":{"applied":{"description":"PTU acumulada a aplicar en el periodo","type":["integer","null"],"minimum":0,"maximum":99999999999999}},"x-scalar-ignore":true},"IsrCompaniesDividendTaxCreditInput":{"type":"object","additionalProperties":false,"properties":{"pending":{"description":"ISR por dividendos pendiente de acreditar","type":["integer","null"],"minimum":0},"applied":{"description":"ISR por dividendos a acreditar en el periodo","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IsrCompaniesPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesInput"},"offsets":{"$ref":"#/components/schemas/OffsetsInput"},"employmentSubsidy":{"description":"Subsidio para el empleo","type":["integer","null"],"minimum":0,"maximum":99999999999999},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/InstallmentsInput"}},"x-scalar-ignore":true},"IsrCompaniesInput":{"type":"object","additionalProperties":false,"description":"ISR personas morales","properties":{"income":{"$ref":"#/components/schemas/IsrCompaniesIncomeInput"},"profitCoefficients":{"type":["object","null"],"additionalProperties":false,"properties":{"lastYear":{"type":["number","null"],"minimum":0,"description":"Coeficiente de utilidad"},"twoYearsAgo":{"type":["number","null"],"minimum":0,"description":"Coeficiente de utilidad"},"threeYearsAgo":{"type":["number","null"],"minimum":0,"description":"Coeficiente de utilidad"},"fourYearsAgo":{"type":["number","null"],"minimum":0,"description":"Coeficiente de utilidad"},"fiveYearsAgo":{"type":["number","null"],"minimum":0,"description":"Coeficiente de utilidad"}}},"authorizedCoefficient":{"description":"¿Tienes autorización para aplicar un coeficiente de utilidad menor?","anyOf":[{"type":"object","additionalProperties":false,"required":["authorizationNumber","authorizedOn","coefficient"],"properties":{"authorizationNumber":{"type":"string","description":"Número de autorización"},"authorizedOn":{"type":"string","format":"date","description":"Fecha de autorización"},"coefficient":{"type":"number","exclusiveMinimum":0,"description":"Coeficiente de utilidad autorizado\n\nCompute uses it in place of SAT's lookup. If SAT looks up another value, saving and submitting fail with `authorized_coefficient_mismatch`.\n\nSAT keeps 4 decimals. If it has more, the request fails with `invalid_request`."}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"mainActivity":{"description":"Actividad preponderante","anyOf":[{"$ref":"#/components/schemas/SatCatalog419"},{"type":"null"}]},"advancesToMembers":{"description":"Anticipos y rendimientos distribuidos en el periodo","type":["integer","null"],"minimum":0,"maximum":99999999999999},"losses":{"description":"¿Tienes pérdidas fiscales de ejercicios anteriores por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"required":["applied"],"properties":{"available":{"type":["integer","null"],"minimum":0,"description":"Pérdida de ejercicios anteriores aplicables"},"applied":{"type":"integer","minimum":0,"description":"Pérdida actualizada por aplicar en el periodo"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"immediateDeduction":{"$ref":"#/components/schemas/IsrCompaniesImmediateDeductionInput"},"profitSharing":{"$ref":"#/components/schemas/IsrCompaniesProfitSharingInput"},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"film":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"filmAndAudiovisual":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulos a proyectos de inversión en las artes","description":"Estímulos a proyectos de inversión en las artes"},"sports":{"type":["object","null"],"additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"dividendTaxCredit":{"$ref":"#/components/schemas/IsrCompaniesDividendTaxCreditInput"},"withheld":{"description":"ISR retenido","type":["integer","null"],"minimum":0},"payment":{"$ref":"#/components/schemas/IsrCompaniesPaymentInput"}},"x-scalar-ignore":true},"IsrSalaryWithholdingsPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOtherInput"},"employmentSubsidy":{"description":"Subsidio para el empleo","type":["integer","null"],"minimum":0,"maximum":99999999999999},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"dieselFreight":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"description":"¿Realizó en las últimas 48 horas un pago para este concepto?","anyOf":[{"type":"object","additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/FirstInstallmentInput"}},"x-scalar-ignore":true},"IsrSalaryWithholdingsInput":{"type":"object","additionalProperties":false,"description":"ISR retenciones por salarios","properties":{"payment":{"$ref":"#/components/schemas/IsrSalaryWithholdingsPaymentInput"}},"x-scalar-ignore":true},"IsrAssimilatedWithholdingsPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOtherInput"},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"dieselFreight":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/InstallmentsInput"}},"x-scalar-ignore":true},"IsrAssimilatedWithholdingsInput":{"type":"object","additionalProperties":false,"description":"ISR retenciones por asimilados a salarios","properties":{"payment":{"$ref":"#/components/schemas/IsrAssimilatedWithholdingsPaymentInput"}},"x-scalar-ignore":true},"IvaResicoActivitiesInput":{"type":"object","additionalProperties":false,"properties":{"taxedAt0":{"description":"Actividades gravadas a la tasa del 0%","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Actividades gravadas a la tasa del 0%"},"domestic":{"type":["integer","null"],"minimum":0,"description":"Actividades nacionales gravadas a la tasa del 0%"},"export":{"type":["integer","null"],"minimum":0,"description":"Actividades de exportación gravadas a la tasa del 0%"}}}},"x-scalar-ignore":true},"IvaResicoPaidInput":{"type":"object","additionalProperties":false,"properties":{"taxedActivities":{"description":"IVA acreditable por actividades gravadas a tasa 16% u 8% y tasa 0%","type":["integer","null"],"minimum":0},"mixedActivities":{"description":"IVA acreditable por actividades mixtas","type":["integer","null"],"minimum":0},"nonCreditable":{"description":"IVA no acreditable","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IvaResicoPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOtherInput"},"offsets":{"$ref":"#/components/schemas/OffsetsInput"},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"conventionCenters":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"},"juicesAndNectars":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/FirstInstallmentInput"}},"x-scalar-ignore":true},"IvaResicoInput":{"type":"object","additionalProperties":false,"description":"IVA simplificado de confianza","properties":{"activities":{"$ref":"#/components/schemas/IvaResicoActivitiesInput"},"paid":{"$ref":"#/components/schemas/IvaResicoPaidInput"},"priorBalance":{"description":"Acreditamiento del saldo a favor de periodos anteriores","type":["integer","null"],"minimum":0},"immediateRefund":{"description":"Devolución inmediata obtenida\n\nOnly for personas morales: from any other taxpayer it fails with `not_applicable`.","type":["integer","null"],"minimum":0},"payment":{"$ref":"#/components/schemas/IvaResicoPaymentInput"}},"x-scalar-ignore":true},"IvaGeneralActivitiesInput":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Valor de los actos o actividades gravados a la tasa del 16%","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Valor de los actos o actividades gravados a la tasa del 16%"},"interest":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Intereses cobrados a la tasa del 16%"},"royalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías entre partes relacionadas a la tasa del 16%"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades gravados a la tasa del 16%"}}},"borderRegion":{"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza"},"northInterest":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Intereses cobrados sujetos al estímulo de la RFN"},"northRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías entre partes relacionadas sujetos al estímulo de la RFN"},"northOther":{"type":["integer","null"],"minimum":0,"description":"Otros actos o actividades gravados sujetos al estímulo de la RFN"},"southInterest":{"type":["integer","null"],"minimum":0,"description":"Intereses cobrados sujetos al estímulo de la RFS"},"southRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías entre partes relacionadas sujetos al estímulo de la RFS"},"southOther":{"type":["integer","null"],"minimum":0,"description":"Otros actos o actividades gravados sujetos al estímulo de la RFS"}}},"export":{"description":"Valor de los actos o actividades gravados a la tasa del 0% exportación","type":["integer","null"],"minimum":0},"taxedAt0":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Valor de los actos o actividades gravados a la tasa del 0% otros"},"primarySector":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Actividades agrícolas, ganaderas, silvícolas o pesqueras gravadas a la tasa del 0% / Actividades agrícolas, ganaderas, silvícolas o pesqueras a la tasa del 0%"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades gravados a la tasa del 0%"}}},"exempt":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos)","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos)"},"landAndHousing":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Enajenación de suelo y construcciones adheridas al suelo, destinadas o utilizadas para casa habitación"},"books":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Enajenación de libros, periódicos y revistas (no editados por el contribuyente)"},"authorsRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías cobradas por autores"},"usedGoods":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Enajenación de bienes muebles usados, excepto los enajenados por empresas"},"lotteryTickets":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Enajenación de billetes y demás comprobantes de loterías, rifas, sorteos o juegos con apuestas y concursos de toda clase"},"education":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Servicios de enseñanza"},"publicTransport":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Servicio de transporte público terrestre de personas"},"derivatives":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Operaciones financieras derivadas"},"eventTickets":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Venta de boletos para espectáculos públicos"},"medicalServices":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Servicios profesionales de medicina"},"housingLeases":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Uso o goce temporal de inmuebles para casa habitación y por fincas para fines agrícolas o ganaderos"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros ingresos exentos de IVA"}}},"notSubject":{"description":"Valor de los actos o actividades no objeto del impuesto","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IvaGeneralAdjustmentsInput":{"type":"object","additionalProperties":false,"properties":{"toRepay":{"description":"Cantidad actualizada a reintegrarse derivada del ajuste","type":["integer","null"],"minimum":0,"maximum":99999999999999},"toCredit":{"description":"Monto acreditable actualizado a incrementar derivado del ajuste","type":["integer","null"],"minimum":0}},"x-scalar-ignore":true},"IvaGeneralPurchasesInput":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA / Valor de los actos o actividades pagados a la tasa del 16%","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA / Valor de los actos o actividades pagados a la tasa del 16%"},"interest":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Intereses pagados a la tasa del 16%"},"royalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías pagadas entre partes relacionadas a la tasa del 16%"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades pagados a la tasa del 16%"}}},"borderRegion":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza / Valor de los actos o actividades pagados sujetos al estímulo de la región fronteriza","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza / Valor de los actos o actividades pagados sujetos al estímulo de la región fronteriza"},"northInterest":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Intereses pagados en la RFN"},"northRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías pagadas entre partes relacionadas en la RFN"},"northOther":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades pagados en la RFN"},"southInterest":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Intereses pagados en la RFS"},"southRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías pagadas entre partes relacionadas en la RFS"},"southOther":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades pagados en la RFS"}}},"imports":{"description":"Total de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16% de IVA / Valor de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Total de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16% de IVA / Valor de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%"},"intangibles":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Importación de bienes intangibles a la tasa del 16%"},"intangiblesUse":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Importación de uso o goce temporal de bienes intangibles a la tasa del 16%"},"services":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Importación de servicios a la tasa del 16%"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%"}}},"taxedAt0":{"description":"Total de los demás actos o actividades pagados a la tasa del 0% de IVA / Valor de los demás actos o actividades pagados a la tasa del 0%","type":["integer","null"],"minimum":0},"exempt":{"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) / Valor de los actos o actividades pagados por los que no se pagará el IVA (exentos)","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) / Valor de los actos o actividades pagados por los que no se pagará el IVA (exentos)"},"landAndHousing":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Adquisición de suelo y construcciones adheridas al suelo, destinadas o utilizadas para casa habitación"},"books":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Adquisición de libros, periódicos o revistas (no editados por el contribuyente)"},"authorsRoyalties":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Regalías pagadas a los autores"},"usedGoods":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Adquisición de bienes muebles usados excepto los adquiridos de empresas"},"publicTransport":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Servicio de transporte público terrestre de personas"},"medicalServices":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Servicios profesionales de medicina"},"agriculturalInsurance":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Aseguramiento contra riesgos agropecuarios"},"farmLeases":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Uso o goce temporal de fincas para fines agrícolas o ganaderos"},"imports":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Actos o actividades pagados en la importación de bienes y servicios exentos"},"other":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Otros actos o actividades pagados exentos"}}}},"x-scalar-ignore":true},"IvaGeneralPaidInput":{"type":"object","additionalProperties":false,"properties":{"taxedActivities":{"type":["object","null"],"additionalProperties":false,"properties":{"purchases":{"type":["integer","null"],"minimum":0,"description":"IVA trasladado por adquisiciones de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes que se utilizan exclusivamente para realizar actos o actividades gravados"},"investments":{"type":["integer","null"],"minimum":0,"description":"IVA trasladado por la adquisición de inversiones destinadas exclusivamente para realizar actos o actividades gravados"},"importedPurchases":{"type":["integer","null"],"minimum":0,"description":"IVA pagado en la importación por adquisición de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes que se utilizan exclusivamente para realizar actos o actividades gravados"},"importedInvestments":{"type":["integer","null"],"minimum":0,"description":"IVA pagado por la importación de inversiones destinadas exclusivamente para realizar actos o actividades gravados"}}},"exemptActivities":{"type":["object","null"],"additionalProperties":false,"properties":{"purchases":{"type":["integer","null"],"minimum":0,"description":"IVA trasladado o pagado en la importación por adquisición de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes destinados exclusivamente para realizar actos o actividades por los que no se está obligado al pago del impuesto / IVA correspondiente a actos o actividades por los que no se está obligado al pago del impuesto"},"investments":{"type":["integer","null"],"minimum":0,"description":"IVA trasladado o pagado en la importación de inversiones destinadas exclusivamente para realizar actos o actividades por los que no se está obligado al pago del impuesto"}}},"mixed":{"type":["object","null"],"additionalProperties":false,"required":["method"],"properties":{"method":{"type":"string","oneOf":[{"const":"1","title":"Art. 5-B de la LIVA"},{"const":"2","title":"Art. 5 de la LIVA"}],"description":"Selecciona la proporción de IVA que aplicarás"},"proportion":{"type":["number","null"],"minimum":0,"maximum":1,"description":"Proporción de IVA"}}}},"x-scalar-ignore":true},"IvaGeneralOtherAmountsInput":{"type":"object","additionalProperties":false,"properties":{"due":{"description":"Otras cantidades a cargo del contribuyente","type":["integer","null"],"minimum":0,"maximum":99999999999999},"inFavor":{"description":"Otras cantidades a favor del contribuyente","type":["integer","null"],"minimum":0,"maximum":99999999999999}},"x-scalar-ignore":true},"IvaGeneralPaymentInput":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesInput"},"offsets":{"$ref":"#/components/schemas/OffsetsInput"},"incentives":{"description":"¿Tienes estímulos por aplicar?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"gasolineNearBorder":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"fuelsComplementary":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"juicesAndNectars":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros"},"conventionCenters":{"type":["integer","null"],"exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}]},"recentPayment":{"$ref":"#/components/schemas/RecentPaymentInput"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPaymentsInput"},"installments":{"$ref":"#/components/schemas/InstallmentsInput"}},"x-scalar-ignore":true},"IvaGeneralInput":{"type":"object","additionalProperties":false,"description":"Impuesto al Valor Agregado. Personas morales / Impuesto al Valor Agregado. Personas físicas","properties":{"activities":{"$ref":"#/components/schemas/IvaGeneralActivitiesInput"},"adjustments":{"$ref":"#/components/schemas/IvaGeneralAdjustmentsInput"},"purchases":{"$ref":"#/components/schemas/IvaGeneralPurchasesInput"},"paid":{"$ref":"#/components/schemas/IvaGeneralPaidInput"},"withheld":{"description":"IVA retenido","type":["object","null"],"additionalProperties":false,"properties":{"total":{"type":["integer","null"],"minimum":0,"description":"IVA retenido"},"onSales":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Por enajenación de bienes"},"onOther":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Por otras operaciones"}}},"otherAmounts":{"$ref":"#/components/schemas/IvaGeneralOtherAmountsInput"},"immediateRefund":{"description":"Devolución inmediata obtenida","type":["integer","null"],"minimum":0,"maximum":99999999999999},"priorBalance":{"description":"Detalle del acreditamiento del saldo a favor del Impuesto al Valor Agregado de periodos anteriores.","type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["periodicity","year","period","amount","declarationType","operationNumber","filedOn","originalBalance","remaining"],"properties":{"periodicity":{"type":"string","oneOf":[{"const":"M","title":"1-Mensual"},{"const":"S","title":"2-Semestral"},{"const":"T","title":"3-Trimestral"}],"description":"Periodicidad"},"year":{"$ref":"#/components/schemas/SatCatalog10EjerciciosInmediatosAnteriores","description":"Ejercicio"},"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodos"},{"$ref":"#/components/schemas/SatCatalogIVAPFPeriodo"}]},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo por aplicar"},"declarationType":{"type":"string","oneOf":[{"const":"001","title":"Normal"},{"const":"002","title":"Complementaria"},{"const":"003","title":"Normal por Corrección Fiscal"},{"const":"004","title":"Complementaria por Corrección Fiscal"},{"const":"005","title":"Complementaria por Dictamen"}],"description":"Tipo de declaración"},"operationNumber":{"type":"string","description":"Número de operación"},"filedOn":{"type":"string","format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalBalance":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto del saldo a favor original"},"remaining":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Remanente histórico antes de la aplicación"}}}},"payment":{"$ref":"#/components/schemas/IvaGeneralPaymentInput"}},"x-scalar-ignore":true},"IsrResicoIndividualIncome":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"Total de ingresos efectivamente cobrados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"discounts":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"Descuentos, devoluciones y bonificaciones amparadas por comprobantes fiscales de egresos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"coOwnership":{"description":"Descuentos, devoluciones y bonificaciones de integrantes por copropiedad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"added":{"description":"Importe\n\nAnswers *¿Tienes ingresos adicionales?*.","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["integer","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"integer","minimum":0},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"subtractions":{"description":"¿Tienes ingresos a disminuir?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"iepsNotSeparated":{"type":"integer","exclusiveMinimum":0,"title":"IEPS cobrado no trasladado de manera expresa y por separado","description":"IEPS cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"accruedInEarlierPeriods":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados acumulados en periodos anteriores","description":"Ingresos facturados acumulados en periodos anteriores"},"governmentSupport":{"type":"integer","exclusiveMinimum":0,"title":"Apoyos gubernamentales","description":"Apoyos gubernamentales"},"onBehalfOfThirdParties":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsNotSeparated":{"type":"integer","exclusiveMinimum":0,"title":"IEPS cobrado no trasladado de manera expresa y por separado","description":"IEPS cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"accruedInEarlierPeriods":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados acumulados en periodos anteriores","description":"Ingresos facturados acumulados en periodos anteriores"},"governmentSupport":{"type":"integer","exclusiveMinimum":0,"title":"Apoyos gubernamentales","description":"Apoyos gubernamentales"},"onBehalfOfThirdParties":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["iepsNotSeparated","pendingCancellation","accruedInEarlierPeriods","governmentSupport","onBehalfOfThirdParties"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"byActivity":{"description":"Detalle de Total de ingresos percibidos por la actividad","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"businessActivity":{"type":"integer","exclusiveMinimum":0,"title":"Actividad empresarial","description":"Actividad empresarial"},"professionalServices":{"type":"integer","exclusiveMinimum":0,"title":"Servicios profesionales (Honorarios)","description":"Servicios profesionales (Honorarios)"},"primarySector":{"type":"integer","exclusiveMinimum":0,"title":"Actividades agrícolas, ganaderas, silvícolas o pesqueras","description":"Actividades agrícolas, ganaderas, silvícolas o pesqueras"},"fixedAssetSales":{"type":"integer","exclusiveMinimum":0,"title":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad","description":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad"},"leasing":{"type":"integer","exclusiveMinimum":0,"title":"Uso o goce temporal de bienes","description":"Uso o goce temporal de bienes"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["object","null"],"additionalProperties":false,"properties":{"businessActivity":{"type":"integer","exclusiveMinimum":0,"title":"Actividad empresarial","description":"Actividad empresarial"},"professionalServices":{"type":"integer","exclusiveMinimum":0,"title":"Servicios profesionales (Honorarios)","description":"Servicios profesionales (Honorarios)"},"primarySector":{"type":"integer","exclusiveMinimum":0,"title":"Actividades agrícolas, ganaderas, silvícolas o pesqueras","description":"Actividades agrícolas, ganaderas, silvícolas o pesqueras"},"fixedAssetSales":{"type":"integer","exclusiveMinimum":0,"title":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad","description":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad"},"leasing":{"type":"integer","exclusiveMinimum":0,"title":"Uso o goce temporal de bienes","description":"Uso o goce temporal de bienes"}},"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["businessActivity","professionalServices","primarySector","fixedAssetSales","leasing"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"coOwnership":{"description":"¿Los ingresos fueron obtenidos a través de copropiedad?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}}},"x-scalar-ignore":true},"IsrResicoIndividualWithheld":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"ISR retenido de facturas emitidas de tipo ingreso","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"added":{"description":"ISR retenido a adicionar","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"subtracted":{"description":"ISR retenido no acreditable","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrResicoIndividualPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/Charges"},"offsets":{"$ref":"#/components/schemas/Offsets"},"incentives":{"description":"¿Tienes estímulos por aplicar?\n\nSAT's form offers no concept for it in this declaration, so a request can only answer *No*, with `false`.","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":"null","description":"What SAT preloaded: nothing, since its form offers no concept."},"declared":{"anyOf":[{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string"},"maxItems":0,"description":"The concepts that SAT's form offers in this declaration: none."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/Installments"}},"x-scalar-ignore":true},"IsrResicoIndividualComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"income":{"description":"Total de ingresos percibidos por la actividad","type":"integer"},"taxableIncome":{"description":"Base gravable","type":"integer"},"rate":{"description":"Tasa aplicable","type":"number"},"tax":{"description":"Impuesto mensual","type":"integer"},"priorPayments":{"description":"Pagos efectuados con anterioridad","type":"integer"},"withheld":{"description":"Total de ISR retenido que es considerado para efectos del acreditamiento","type":"integer"},"withheldCredited":{"description":"ISR retenido por personas morales","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"taxInFavor":{"description":"Impuesto a favor","type":"integer"},"amountDue":{"description":"Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IsrResicoIndividualInvoices":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Total de ingresos efectivamente cobrados","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"}}},"paymentComplements":{"description":"Suma de facturas emitidas de tipo pago donde la fecha de pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"}}}}},"discounts":{"description":"Detalle de  Descuentos, devoluciones y bonificaciones","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"}}},"withheld":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de ISR retenido","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos"}}},"paymentComplements":{"description":"ISR retenido suma de facturas emitidas de tipo pago donde la fecha de pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos - ISR"}}}}}},"x-scalar-ignore":true},"IsrResicoIndividualEarlierPeriods":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"description":"Detalle de Ingresos cobrados y amparados por facturas de periodos anteriores 2025","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","primarySector","fixedAssetSales","total"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"primarySector":{"type":["integer","null"],"minimum":0,"description":"Actividades agrícolas, ganaderas, silvícolas y pesqueras"},"fixedAssetSales":{"type":["integer","null"],"minimum":0,"description":"Enajenación de activos fijos y terrenos de su propiedad afectos a su actividad"},"total":{"type":["integer","null"],"minimum":0,"description":"Total de ingresos percibidos por la actividad"}}}}},"x-scalar-ignore":true},"IsrResicoIndividual":{"type":"object","additionalProperties":false,"description":"ISR simplificado de confianza. Personas físicas","properties":{"income":{"$ref":"#/components/schemas/IsrResicoIndividualIncome"},"withheld":{"$ref":"#/components/schemas/IsrResicoIndividualWithheld"},"priorPayments":{"description":"Detalle Pagos efectuados con anterioridad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["regime","year","periodicity","period","operationNumber","amount"],"properties":{"regime":{"type":"string","oneOf":[{"const":"R2","title":"Actividad Empresarial y Servicios Profesionales"},{"const":"R3","title":"Arrendamiento"},{"const":"R4","title":"Ambos"}],"description":"Régimen fiscal"},"year":{"type":"string","oneOf":[{"const":"2026","title":"2026"},{"const":"2025","title":"2025"},{"const":"2024","title":"2024"},{"const":"2023","title":"2023"},{"const":"2022","title":"2022"}],"description":"Ejercicio"},"periodicity":{"type":"string","oneOf":[{"const":"PD2","title":"Mensual"},{"const":"PD3","title":"Trimestral"},{"const":"PD4","title":"Del ejercicio"}],"description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodoPPRESICOPF","description":"Periodo"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Pagos a disminuir"}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["regime","year","periodicity","period","operationNumber","amount"],"properties":{"regime":{"type":"string","oneOf":[{"const":"R2","title":"Actividad Empresarial y Servicios Profesionales"},{"const":"R3","title":"Arrendamiento"},{"const":"R4","title":"Ambos"}],"description":"Régimen fiscal"},"year":{"type":"string","oneOf":[{"const":"2026","title":"2026"},{"const":"2025","title":"2025"},{"const":"2024","title":"2024"},{"const":"2023","title":"2023"},{"const":"2022","title":"2022"}],"description":"Ejercicio"},"periodicity":{"type":"string","oneOf":[{"const":"PD2","title":"Mensual"},{"const":"PD3","title":"Trimestral"},{"const":"PD4","title":"Del ejercicio"}],"description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodoPPRESICOPF","description":"Periodo"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Pagos a disminuir"}}},"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"payment":{"$ref":"#/components/schemas/IsrResicoIndividualPayment"},"computed":{"$ref":"#/components/schemas/IsrResicoIndividualComputed"},"invoices":{"$ref":"#/components/schemas/IsrResicoIndividualInvoices"},"earlierPeriods":{"$ref":"#/components/schemas/IsrResicoIndividualEarlierPeriods"}},"x-scalar-ignore":true},"IsrBusinessIncome":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"Ingresos cobrados del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"subtractions":{"description":"¿Tienes ingresos a disminuir del mes?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado"},"accruedInEarlierPeriods":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"invoicedWithGainOnSale":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"pendingCancellation":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithExchangeGain":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"},"visualArtists":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos de personas físicas dedicadas a las artes plásticas","description":"Ingresos de personas físicas dedicadas a las artes plásticas"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS / ISAN cobrado no trasladado de manera expresa y por separado"},"accruedInEarlierPeriods":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"invoicedWithGainOnSale":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"pendingCancellation":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithExchangeGain":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"},"visualArtists":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos de personas físicas dedicadas a las artes plásticas","description":"Ingresos de personas físicas dedicadas a las artes plásticas"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["iepsIsanNotSeparated","accruedInEarlierPeriods","invoicedWithGainOnSale","pendingCancellation","invoicedWithExchangeGain","visualArtists"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"added":{"description":"¿Tienes ingresos adicionales del mes?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"debtRelief":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Condonaciones, quitas o remisiones","description":"Condonaciones, quitas o remisiones"},"thirdPartyExpenses":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Gastos por cuenta de terceros sin comprobante fiscal","description":"Gastos por cuenta de terceros sin comprobante fiscal"},"interest":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales","description":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales"},"gainOnSales":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia por enajenación de activos","description":"Ganancia por enajenación de activos"},"exchangeGains":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"},"freightCoordinated":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)","description":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)"},"invoicedNotPrefilled":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados no considerados en el prellenado","description":"Ingresos facturados no considerados en el prellenado"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"debtRelief":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Condonaciones, quitas o remisiones","description":"Condonaciones, quitas o remisiones"},"thirdPartyExpenses":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Gastos por cuenta de terceros sin comprobante fiscal","description":"Gastos por cuenta de terceros sin comprobante fiscal"},"interest":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales","description":"Intereses cobrados derivados de la actividad empresarial o de la prestación de servicios profesionales"},"gainOnSales":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia por enajenación de activos","description":"Ganancia por enajenación de activos"},"exchangeGains":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"},"freightCoordinated":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)","description":"Ingresos derivados de las actividades de autotransporte (integrantes de coordinados)"},"invoicedNotPrefilled":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Ingresos facturados no considerados en el prellenado","description":"Ingresos facturados no considerados en el prellenado"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["debtRelief","thirdPartyExpenses","interest","gainOnSales","exchangeGains","freightCoordinated","invoicedNotPrefilled"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"exempt":{"description":"Ingresos exentos del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"coOwnership":{"description":"¿Tus ingresos fueron obtenidos en copropiedad o sociedad conyugal?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["representativeRfc","members"],"properties":{"representativeRfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del representante común"},"members":{"type":"array","description":"Detalle Ingresos obtenidos a través de copropiedad","minItems":1,"items":{"type":"object","additionalProperties":false,"required":["rfc","share","income","taxPaid"],"properties":{"rfc":{"type":"string","minLength":12,"maxLength":13,"pattern":"^[A-ZÑ&]{3,4}[0-9]{6}[A-Z0-9]{3}$","description":"RFC del integrante"},"share":{"type":"number","minimum":0.01,"maximum":99.99,"description":"Porcentaje de participación en la copropiedad"},"income":{"type":"integer","minimum":0,"description":"Total de ingresos obtenidos por el integrante"},"taxPaid":{"type":"integer","minimum":0,"description":"ISR pagado por el integrante"}}}}}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}}},"x-scalar-ignore":true},"IsrBusinessDeductions":{"type":"object","additionalProperties":false,"properties":{"payroll":{"description":"Gastos de nómina del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"purchases":{"type":"object","additionalProperties":false,"properties":{"notDeductible":{"description":"Compras y gastos no deducibles del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"notPrefilled":{"description":"Compras y gastos del mes no considerados en el pre llenado","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"creditNotesReceived":{"description":"Facturas de egresos recibidas por compras y gastos del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"investments":{"description":"Deducción de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"immediateDeduction":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Detalle de Deducción inmediata de inversiones Decreto Relocalización › Deducción inmediata de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"planMexico":{"description":"Detalle de Deducción inmediata de inversiones Decreto Plan Mexico › Deducción inmediata de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"incentives":{"description":"¿Tienes facilidades administrativas y estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"olderWorkers":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por contratar adultos mayores (25% del salario pagado)","description":"Estímulo por contratar adultos mayores (25% del salario pagado)"},"workersWithDisabilities":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad","description":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad"},"booksAndPress":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción adicional por enajenación de libros, periódicos y revistas","description":"Deducción adicional por enajenación de libros, periódicos y revistas"},"freightUndocumented":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte","description":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte"},"landForDevelopment":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios","description":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios"},"donationsToAgencies":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal.","description":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal."}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"olderWorkers":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por contratar adultos mayores (25% del salario pagado)","description":"Estímulo por contratar adultos mayores (25% del salario pagado)"},"workersWithDisabilities":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad","description":"Deducción del 25% del salario pagado por la contratación de personas que padezcan discapacidad"},"booksAndPress":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción adicional por enajenación de libros, periódicos y revistas","description":"Deducción adicional por enajenación de libros, periódicos y revistas"},"freightUndocumented":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte","description":"Deducción equivalente hasta 8% de ingresos propios sin documentación que reúna requisitos fiscales para contribuyentes dedicados exclusivamente al autotransporte"},"landForDevelopment":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios","description":"Deducción del costo de adquisición de terrenos por contribuyentes dedicados a la construcción y desarrollos inmobiliarios"},"donationsToAgencies":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal.","description":"Deducción de donativos realizados a organismos públicos descentralizados del Gobierno Federal."}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["olderWorkers","workersWithDisabilities","booksAndPress","freightUndocumented","landForDevelopment","donationsToAgencies"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}}},"x-scalar-ignore":true},"IsrBusinessProfitSharing":{"type":"object","additionalProperties":false,"properties":{"applied":{"description":"PTU acumulada a aplicar en el periodo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrBusinessUndocumentedDeduction":{"type":"object","additionalProperties":false,"properties":{"creditedIncentives":{"description":"Estímulos acreditables","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"creditedIncentivesByConcept":{"description":"Detalle de Estímulos acreditables","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["object","null"],"additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":"integer","maximum":99999999999999,"exclusiveMinimum":0,"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}},"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["filmAndAudiovisual","arts","sports","film","dieselPassengers","dieselFreight","dieselTourism","tollsPassengers","tollsFreight","tollsTourism"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"priorPayments":{"description":"Pagos provisionales de periodos anteriores","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrBusinessPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/Charges"},"offsets":{"$ref":"#/components/schemas/Offsets"},"employmentSubsidy":{"description":"Subsidio para el empleo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["gasolineNearBorder","gasolineBorder","fuelsComplementary"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/Installments"}},"x-scalar-ignore":true},"IsrBusinessComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"monthIncome":{"description":"Ingresos del mes","type":"integer"},"exemptIncome":{"description":"Ingresos exentos","type":"integer"},"earlierIncome":{"description":"Ingresos de meses anteriores","type":"integer"},"income":{"description":"Total de ingresos del periodo","type":"integer"},"payroll":{"description":"Gastos de nómina del periodo no considerados en el prellenado","type":"integer"},"purchasesInvoiced":{"description":"Compras y gastos facturados del mes","type":"integer"},"discountsInvoiced":{"description":"Devoluciones, descuentos y bonificaciones facturadas del mes","type":"integer"},"purchasesForMonth":{"description":"Compras y gastos deducibles del mes","type":"integer"},"purchases":{"description":"Compras y gastos del periodo","type":"integer"},"investments":{"description":"Deducción de inversiones del periodo","type":"integer"},"immediateDeduction":{"description":"Deducción inmediata de inversiones","type":"integer"},"deductionIncentives":{"description":"Estímulos a disminuir","type":"integer"},"deductions":{"description":"Total de deducciones autorizadas","type":"integer"},"profitSharingPaidEarlier":{"description":"PTU pagada en meses anteriores, solo declaraciones pagadas","type":"integer"},"profitSharingPaid":{"description":"PTU pagada en el mes","type":"integer"},"profitSharing":{"description":"Participación de los trabajadores en las utilidades","type":"integer"},"losses":{"description":"Pérdidas fiscales de ejercicios anteriores que se aplican en el periodo","type":"integer"},"taxableIncome":{"description":"Base gravable","type":"integer"},"tax":{"description":"Impuesto causado","type":"integer"},"taxIncentives":{"description":"Estímulos al impuesto causado","type":"integer"},"taxForPeriod":{"description":"Impuesto del periodo","type":"integer"},"resicoPayments":{"description":"Pagos provisionales efectuados en el Régimen Simplificado de Confianza","type":"integer"},"withheld":{"description":"Total de ISR retenido","type":"integer"},"taxDue":{"description":"Determinación › Impuesto a cargo","type":"integer"},"undocumentedDeduction":{"description":"Monto total deducible 8%","type":"integer"},"undocumentedTax":{"description":"Impuesto causado (Tasa 16%)","type":"integer"},"undocumentedTaxDue":{"description":"Determinación del ISR por el monto que haya sido deducido sin documentación que reúna requisitos fiscales › Impuesto a cargo","type":"integer"},"amountDue":{"description":"Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IsrBusinessInvoices":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Ingresos cobrados del mes Pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Cancelados"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"}}},"paymentComplements":{"description":"Detalle de Ingresos cobrados del mes corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Cancelados"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"}}}}},"purchases":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de ingresos facturados del mes PUE","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal-Descuento"}}},"paymentComplements":{"description":"Detalle de pagos facturados del mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Importe pagado sin impuestos"}}}}},"discounts":{"type":"object","additionalProperties":false,"properties":{"incomeInvoices":{"description":"Detalle de Devoluciones, descuentos y bonificaciones facturas del mes. Suma de facturas ingreso del mes (PUE).","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"}}},"creditNotes":{"description":"Detalle de Devoluciones, descuentos y bonificaciones facturas del mes. Suma de facturas egreso del mes (PUE).","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"}}}}},"creditNotesReceived":{"description":"Detalle de Facturas de egresos recibidas por compras y gastos del mes PUE","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"}}}},"x-scalar-ignore":true},"IsrBusinessEarlierPeriods":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"description":"Detalle de Ingresos de meses anteriores","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","borderRegionNorth","borderRegionSouth","borderRegionNotSubject","income","total","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"borderRegionNorth":{"type":["integer","null"],"minimum":0,"description":"Ingresos exclusivos dentro de la RFN"},"borderRegionSouth":{"type":["integer","null"],"minimum":0,"description":"Ingresos exclusivos dentro de la RFS"},"borderRegionNotSubject":{"type":["integer","null"],"minimum":0,"description":"Ingresos del mes no sujetos al estímulo"},"income":{"type":["integer","null"],"minimum":0,"description":"Ingresos"},"total":{"type":["integer","null"],"minimum":0,"description":"Total"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"exemptIncome":{"description":"Detalle de Ingresos exentos","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","exempt","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"exempt":{"type":["integer","null"],"minimum":0,"description":"Ingresos exentos"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"payroll":{"description":"Gastos de nómina del periodo","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","payroll","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"payroll":{"type":["integer","null"],"minimum":0,"description":"Gastos de nómina"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"purchases":{"description":"Compras y gastos de meses anteriores, solo declaraciones pagadas","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","purchases","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"purchases":{"type":["integer","null"],"minimum":0,"description":"Compras y gastos"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"investments":{"description":"Deducción de inversiones del periodo","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"No. de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"immediateDeduction":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Detalle de Deducción inmediata de inversiones","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Deducción inmediata de inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"No. de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"planMexico":{"description":"Detalle de Deducción inmediata de inversiones Decreto Plan Mexico Periodos anteriores","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Deducción inmediata de inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"No. de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}}}},"profitSharing":{"description":"Participación de los trabajadores en las utilidades","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","paid","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"paid":{"type":["integer","null"],"minimum":0,"description":"PTU pagada"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"payments":{"description":"Pagos provisionales efectuados con anterioridad","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","taxDue","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"taxDue":{"type":["integer","null"],"minimum":0,"description":"Impuesto a cargo"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"withheld":{"description":"ISR retenido","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","withheld","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"withheld":{"type":["integer","null"],"minimum":0,"description":"ISR retenido"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}}},"x-scalar-ignore":true},"IsrBusiness":{"type":"object","additionalProperties":false,"description":"ISR personas físicas. Actividad empresarial y profesional","properties":{"income":{"$ref":"#/components/schemas/IsrBusinessIncome"},"deductions":{"$ref":"#/components/schemas/IsrBusinessDeductions"},"profitSharing":{"$ref":"#/components/schemas/IsrBusinessProfitSharing"},"losses":{"type":"object","additionalProperties":false,"properties":{"available":{"description":"Pérdida de ejercicios anteriores aplicables","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"applied":{"description":"Pérdida actualizada por aplicar en el periodo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"taxIncentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"filmAndAudiovisual":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo a proyectos de inversión en las artes","description":"Estímulo a proyectos de inversión en las artes"},"sports":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"},"film":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"dieselPassengers":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselFreight":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselTourism":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"tollsPassengers":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de personas","description":"Crédito 50% en el pago de peaje para transporte público de personas"},"tollsFreight":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público de carga","description":"Crédito 50% en el pago de peaje para transporte público de carga"},"tollsTourism":{"type":"object","additionalProperties":false,"required":["pending","authorized","applied"],"properties":{"pending":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo pendiente de aplicar de ejercicios anteriores"},"authorized":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Crédito 50% en el pago de peaje para transporte público turístico","description":"Crédito 50% en el pago de peaje para transporte público turístico"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["filmAndAudiovisual","arts","sports","film","dieselPassengers","dieselFreight","dieselTourism","tollsPassengers","tollsFreight","tollsTourism"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"priorPayments":{"description":"Pagos provisionales efectuados con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"resicoPayments":{"description":"Detalle Pagos provisionales efectuados en el Régimen Simplificado de Confianza","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["month","operationNumber","amount"],"properties":{"month":{"$ref":"#/components/schemas/SatCatalogMeses","description":"Mes"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto pagado"}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["month","operationNumber","amount"],"properties":{"month":{"$ref":"#/components/schemas/SatCatalogMeses","description":"Mes"},"operationNumber":{"type":"string","maxLength":14,"description":"Número de operación"},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto pagado"}}},"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"withheld":{"description":"ISR retenido del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"undocumentedDeduction":{"$ref":"#/components/schemas/IsrBusinessUndocumentedDeduction"},"payment":{"$ref":"#/components/schemas/IsrBusinessPayment"},"computed":{"$ref":"#/components/schemas/IsrBusinessComputed"},"invoices":{"$ref":"#/components/schemas/IsrBusinessInvoices"},"earlierPeriods":{"$ref":"#/components/schemas/IsrBusinessEarlierPeriods"}},"x-scalar-ignore":true},"IsrCompaniesIncome":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"Ingresos nominales facturados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"added":{"description":"¿Tienes ingresos nominales adicionales?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"gainOnSales":{"type":"integer","exclusiveMinimum":0,"title":"Ganancia por enajenación","description":"Ganancia por enajenación"},"invoicedEarlierCollectedNow":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignIncome":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos del extranjero","description":"Ingresos del extranjero"},"accruedWithoutInvoice":{"type":"integer","exclusiveMinimum":0,"title":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación","description":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación"},"interest":{"type":"integer","exclusiveMinimum":0,"title":"Intereses (Artículo 8 LISR)","description":"Intereses (Artículo 8 LISR)"},"debtNotPaid":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos derivados de deuda no cubierta","description":"Ingresos derivados de deuda no cubierta"},"exchangeGains":{"type":"integer","exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"gainOnSales":{"type":"integer","exclusiveMinimum":0,"title":"Ganancia por enajenación","description":"Ganancia por enajenación"},"invoicedEarlierCollectedNow":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados de periodos anteriores cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignIncome":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos del extranjero","description":"Ingresos del extranjero"},"accruedWithoutInvoice":{"type":"integer","exclusiveMinimum":0,"title":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación","description":"Envío o entrega del bien o prestación del servicio así como cuando se cobre o sea exigible el precio o la contraprestación"},"interest":{"type":"integer","exclusiveMinimum":0,"title":"Intereses (Artículo 8 LISR)","description":"Intereses (Artículo 8 LISR)"},"debtNotPaid":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos derivados de deuda no cubierta","description":"Ingresos derivados de deuda no cubierta"},"exchangeGains":{"type":"integer","exclusiveMinimum":0,"title":"Ganancia efectivamente percibida por fluctuación cambiaria","description":"Ganancia efectivamente percibida por fluctuación cambiaria"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["gainOnSales","invoicedEarlierCollectedNow","foreignIncome","accruedWithoutInvoice","interest","debtNotPaid","exchangeGains"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"subtractions":{"description":"¿Tienes ingresos nominales a disminuir?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":"integer","exclusiveMinimum":0,"title":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithGainOnSale":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"invoicedNotCollected":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignWithheld":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos del extranjero sujetos a retención o pago de impuesto","description":"Ingresos del extranjero sujetos a retención o pago de impuesto"},"accruedInEarlierPeriods":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"onBehalfOfThirdParties":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"},"accruedOnCollection":{"type":"integer","exclusiveMinimum":0,"title":"Por acumulación del cobro total o parcial del precio en el ejercicio","description":"Por acumulación del cobro total o parcial del precio en el ejercicio"},"foreignPensionFunds":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero","description":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero"},"invoicedWithExchangeGain":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"iepsIsanNotSeparated":{"type":"integer","exclusiveMinimum":0,"title":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado","description":"IEPS/ISAN cobrado no trasladado de manera expresa y por separado"},"pendingCancellation":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados pendientes de cancelación con aceptación del receptor","description":"Ingresos facturados pendientes de cancelación con aceptación del receptor"},"invoicedWithGainOnSale":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por enajenación","description":"Ingresos facturados en los que se determinó ganancia por enajenación"},"invoicedNotCollected":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)","description":"Ingresos facturados no cobrados en el periodo (sociedades o asociaciones civiles)"},"foreignWithheld":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos del extranjero sujetos a retención o pago de impuesto","description":"Ingresos del extranjero sujetos a retención o pago de impuesto"},"accruedInEarlierPeriods":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos acumulados en periodos anteriores","description":"Ingresos acumulados en periodos anteriores"},"onBehalfOfThirdParties":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados a cuenta de terceros","description":"Ingresos facturados a cuenta de terceros"},"accruedOnCollection":{"type":"integer","exclusiveMinimum":0,"title":"Por acumulación del cobro total o parcial del precio en el ejercicio","description":"Por acumulación del cobro total o parcial del precio en el ejercicio"},"foreignPensionFunds":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero","description":"Ingresos exentos, derivados de las inversiones efectuadas por fondos de pensiones y jubilaciones constituidas en el extranjero"},"invoicedWithExchangeGain":{"type":"integer","exclusiveMinimum":0,"title":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria","description":"Ingresos facturados en los que se determinó ganancia por fluctuación cambiaria"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["iepsIsanNotSeparated","pendingCancellation","invoicedWithGainOnSale","invoicedNotCollected","foreignWithheld","accruedInEarlierPeriods","onBehalfOfThirdParties","accruedOnCollection","foreignPensionFunds","invoicedWithExchangeGain"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"borderRegion":{"type":"object","additionalProperties":false,"properties":{"north":{"description":"Ingresos nominales exclusivos dentro de la región fronteriza norte","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"south":{"description":"Ingresos nominales exclusivos dentro de la región fronteriza sur","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"notSubject":{"description":"Ingresos nominales no sujetos al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}}},"x-scalar-ignore":true},"IsrCompaniesProfitSharing":{"type":"object","additionalProperties":false,"properties":{"paidThroughMay":{"description":"PTU pagada al mes de mayo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"applied":{"description":"PTU acumulada a aplicar en el periodo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrCompaniesImmediateDeduction":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Total Detalle de Deducción inmediata de inversiones Relocalización › Deducción inmediata de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"planSonora":{"description":"Total Detalle de Deducción inmediata de inversiones Plan Sonora › Deducción inmediata de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"planMexico":{"description":"Total Detalle de Deducción inmediata de inversiones Plan México › Deducción inmediata de inversiones del mes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrCompaniesDividendTaxCredit":{"type":"object","additionalProperties":false,"properties":{"pending":{"description":"ISR por dividendos pendiente de acreditar","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"applied":{"description":"ISR por dividendos a acreditar en el periodo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrCompaniesPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/Charges"},"offsets":{"$ref":"#/components/schemas/Offsets"},"employmentSubsidy":{"description":"Subsidio para el empleo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["gasolineNearBorder","gasolineBorder","fuelsComplementary"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/Installments"}},"x-scalar-ignore":true},"IsrCompaniesComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"monthIncome":{"description":"Ingresos nominales","type":"integer"},"earlierIncome":{"description":"Ingresos nominales de periodos anteriores","type":"integer"},"income":{"description":"Total de ingresos nominales del periodo","type":"integer"},"profitCoefficient":{"description":"Coeficiente de utilidad","type":"number"},"profit":{"description":"Utilidad fiscal para pago provisional","type":"integer"},"profitSharing":{"description":"Participación de los trabajadores en las utilidades","type":"integer"},"losses":{"description":"Pérdidas fiscales de ejercicios anteriores que se aplican en el periodo","type":"integer"},"taxableProfit":{"description":"Base gravable del pago provisional","type":"integer"},"tax":{"description":"Impuesto causado","type":"integer"},"taxForPeriod":{"description":"Impuesto del periodo","type":"integer"},"dividendTaxCredit":{"description":"Impuesto acreditable por dividendos o utilidades distribuidas","type":"integer"},"priorPayments":{"description":"Pagos provisionales efectuados de periodos anteriores","type":"integer"},"withheld":{"description":"Total de ISR retenido del periodo","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"amountDue":{"description":"Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IsrCompaniesInvoices":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"description":"Detalle de Ingresos nominales facturados del periodo","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"}}}},"x-scalar-ignore":true},"IsrCompaniesEarlierPeriods":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"income":{"description":"Ingresos nominales de periodos anteriores","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","income","borderRegionNorth","borderRegionSouth","borderRegionNotSubject","status","operationNumber","filedOn"],"properties":{"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"income":{"type":["integer","null"],"minimum":0,"description":"Ingresos nominales"},"borderRegionNorth":{"type":["integer","null"],"minimum":0,"description":"Ingresos nominales exclusivos dentro de la RFN"},"borderRegionSouth":{"type":["integer","null"],"minimum":0,"description":"Ingresos nominales exclusivos dentro de la RFS"},"borderRegionNotSubject":{"type":["integer","null"],"minimum":0,"description":"Ingresos nominales no sujetos al estímulo"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"payments":{"description":"Pagos provisionales efectuados de periodos anteriores","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","taxDue","status","operationNumber","filedOn"],"properties":{"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"taxDue":{"type":["integer","null"],"minimum":0,"description":"Impuesto a cargo"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"withheld":{"description":"Impuesto retenido de periodos anteriores","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","withheld","status","operationNumber","filedOn"],"properties":{"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"withheld":{"type":["integer","null"],"minimum":0,"description":"ISR retenido de periodos anteriores"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"immediateDeduction":{"type":"object","additionalProperties":false,"properties":{"relocation":{"description":"Deducción inmediata de inversiones Relocalización","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Deducción inmediata de inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"maxLength":15,"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"planSonora":{"description":"Deducción inmediata de inversiones Plan Sonora","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Deducción inmediata de inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}},"planMexico":{"description":"Deducción inmediata de inversiones Plan México","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["period","deduction","status","operationNumber","filedOn"],"properties":{"period":{"description":"Mes","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodo"},{"type":"null"}]},"deduction":{"type":["integer","null"],"minimum":0,"description":"Deducción inmediata de inversiones"},"status":{"description":"Estatus","anyOf":[{"$ref":"#/components/schemas/SatCatalogEstatusDeDeclaracionesProvicionales"},{"type":"null"}]},"operationNumber":{"type":["string","null"],"description":"N° de operación de declaración"},"filedOn":{"type":["string","null"],"format":"date","description":"Fecha de presentación de la declaración"}}}}}}},"x-scalar-ignore":true},"IsrCompanies":{"type":"object","additionalProperties":false,"description":"ISR personas morales","properties":{"income":{"$ref":"#/components/schemas/IsrCompaniesIncome"},"profitCoefficients":{"type":"object","additionalProperties":false,"properties":{"lastYear":{"description":"Coeficiente de utilidad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"twoYearsAgo":{"description":"Coeficiente de utilidad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"threeYearsAgo":{"description":"Coeficiente de utilidad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"fourYearsAgo":{"description":"Coeficiente de utilidad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"fiveYearsAgo":{"description":"Coeficiente de utilidad","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}}}},"authorizedCoefficient":{"description":"¿Tienes autorización para aplicar un coeficiente de utilidad menor?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"required":["authorizationNumber","authorizedOn","coefficient"],"properties":{"authorizationNumber":{"type":"string","description":"Número de autorización"},"authorizedOn":{"type":"string","format":"date","description":"Fecha de autorización"},"coefficient":{"type":"number","exclusiveMinimum":0,"description":"Coeficiente de utilidad autorizado\n\nCompute uses it in place of SAT's lookup. If SAT looks up another value, saving and submitting fail with `authorized_coefficient_mismatch`.\n\nSAT keeps 4 decimals. If it has more, the request fails with `invalid_request`."}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"required":["authorizationNumber","authorizedOn","coefficient"],"properties":{"authorizationNumber":{"type":"string","description":"Número de autorización"},"authorizedOn":{"type":"string","format":"date","description":"Fecha de autorización"},"coefficient":{"type":"number","exclusiveMinimum":0,"description":"Coeficiente de utilidad autorizado\n\nCompute uses it in place of SAT's lookup. If SAT looks up another value, saving and submitting fail with `authorized_coefficient_mismatch`.\n\nSAT keeps 4 decimals. If it has more, the request fails with `invalid_request`."}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"mainActivity":{"description":"Actividad preponderante","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"anyOf":[{"$ref":"#/components/schemas/SatCatalog419"},{"type":"null"}],"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"$ref":"#/components/schemas/SatCatalog419"},{"type":"null"}],"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"advancesToMembers":{"description":"Anticipos y rendimientos distribuidos en el periodo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"profitSharing":{"$ref":"#/components/schemas/IsrCompaniesProfitSharing"},"losses":{"description":"¿Tienes pérdidas fiscales de ejercicios anteriores por aplicar?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"required":["applied"],"properties":{"available":{"type":"integer","minimum":0,"description":"Pérdida de ejercicios anteriores aplicables"},"applied":{"type":"integer","minimum":0,"description":"Pérdida actualizada por aplicar en el periodo"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"required":["applied"],"properties":{"available":{"type":"integer","minimum":0,"description":"Pérdida de ejercicios anteriores aplicables"},"applied":{"type":"integer","minimum":0,"description":"Pérdida actualizada por aplicar en el periodo"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"immediateDeduction":{"$ref":"#/components/schemas/IsrCompaniesImmediateDeduction"},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"film":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"filmAndAudiovisual":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulos a proyectos de inversión en las artes","description":"Estímulos a proyectos de inversión en las artes"},"sports":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"film":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Producción cinematográfica","description":"Producción cinematográfica"},"filmAndAudiovisual":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estimulo a la producción cinematográfica y audiovisual","description":"Estimulo a la producción cinematográfica y audiovisual"},"arts":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulos a proyectos de inversión en las artes","description":"Estímulos a proyectos de inversión en las artes"},"sports":{"type":"object","additionalProperties":false,"required":["authorized","applied"],"properties":{"authorized":{"type":"integer","minimum":0,"description":"Estímulo autorizado en el periodo que se declara"},"applied":{"type":"integer","minimum":0,"description":"Por aplicar en el periodo"}},"title":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento","description":"Estímulo por la inversión en proyectos y programas para el deporte de alto rendimiento"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["film","filmAndAudiovisual","arts","sports"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"dividendTaxCredit":{"$ref":"#/components/schemas/IsrCompaniesDividendTaxCredit"},"withheld":{"description":"ISR retenido","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"payment":{"$ref":"#/components/schemas/IsrCompaniesPayment"},"computed":{"$ref":"#/components/schemas/IsrCompaniesComputed"},"invoices":{"$ref":"#/components/schemas/IsrCompaniesInvoices"},"earlierPeriods":{"$ref":"#/components/schemas/IsrCompaniesEarlierPeriods"}},"x-scalar-ignore":true},"IsrSalaryWithholdingsPayroll":{"type":"object","additionalProperties":false,"properties":{"employees":{"description":"Número de trabajadores por sueldos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"paid":{"description":"Pagos de sueldos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"exempt":{"description":"Pagos exentos de sueldos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"withheld":{"description":"ISR retenido por sueldos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrSalaryWithholdingsPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOther"},"employmentSubsidy":{"description":"Subsidio para el empleo","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"dieselFreight":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"dieselFreight":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["dieselFreight","dieselPassengers","dieselTourism","dieselFarming"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"description":"¿Realizó en las últimas 48 horas un pago para este concepto?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/FirstInstallment"}},"x-scalar-ignore":true},"IsrSalaryWithholdingsComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"amountDue":{"description":"Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IsrSalaryWithholdings":{"type":"object","additionalProperties":false,"description":"ISR retenciones por salarios","properties":{"payroll":{"$ref":"#/components/schemas/IsrSalaryWithholdingsPayroll"},"payment":{"$ref":"#/components/schemas/IsrSalaryWithholdingsPayment"},"computed":{"$ref":"#/components/schemas/IsrSalaryWithholdingsComputed"}},"x-scalar-ignore":true},"IsrAssimilatedWithholdingsPayroll":{"type":"object","additionalProperties":false,"properties":{"employees":{"description":"Número de trabajadores por asimilados a salarios","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"paid":{"description":"Pagos de asimilados a salarios","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"withheld":{"description":"ISR retenido por asimilados a salarios","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IsrAssimilatedWithholdingsPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOther"},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"dieselFreight":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"dieselFreight":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de carga","description":"Crédito IEPS diésel automotriz para transporte público de carga"},"dieselPassengers":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público de personas","description":"Crédito IEPS diésel automotriz para transporte público de personas"},"dieselTourism":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel automotriz para transporte público turístico","description":"Crédito IEPS diésel automotriz para transporte público turístico"},"dieselFarming":{"type":"integer","exclusiveMinimum":0,"title":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor","description":"Crédito IEPS diésel para actividades agropecuarias o silvícolas por aplicación de factor"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["dieselFreight","dieselPassengers","dieselTourism","dieselFarming"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/Installments"}},"x-scalar-ignore":true},"IsrAssimilatedWithholdingsComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"amountDue":{"description":"Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IsrAssimilatedWithholdings":{"type":"object","additionalProperties":false,"description":"ISR retenciones por asimilados a salarios","properties":{"payroll":{"$ref":"#/components/schemas/IsrAssimilatedWithholdingsPayroll"},"payment":{"$ref":"#/components/schemas/IsrAssimilatedWithholdingsPayment"},"computed":{"$ref":"#/components/schemas/IsrAssimilatedWithholdingsComputed"}},"x-scalar-ignore":true},"IvaResicoActivities":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Actividades gravadas a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedAt8":{"description":"Actividades sujetas al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedAt0":{"description":"Actividades gravadas a la tasa del 0%","type":"object","additionalProperties":false,"properties":{"total":{"description":"Actividades gravadas a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"domestic":{"description":"Actividades nacionales gravadas a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"export":{"description":"Actividades de exportación gravadas a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"exempt":{"description":"Actividades exentas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"notSubject":{"description":"Actividades no objeto del impuesto","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaResicoReturns":{"type":"object","additionalProperties":false,"properties":{"sales":{"description":"IVA no cobrado por devoluciones, descuentos y bonificaciones de ventas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"purchases":{"description":"IVA por devoluciones, descuentos y bonificaciones en gastos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaResicoPaid":{"type":"object","additionalProperties":false,"properties":{"invoiced":{"description":"IVA pagado en gastos y adquisiciones","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedActivities":{"description":"IVA acreditable por actividades gravadas a tasa 16% u 8% y tasa 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"mixedActivities":{"description":"IVA acreditable por actividades mixtas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"nonCreditable":{"description":"IVA no acreditable","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaResicoPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/ChargesWithoutOther"},"offsets":{"$ref":"#/components/schemas/Offsets"},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"conventionCenters":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"},"juicesAndNectars":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"conventionCenters":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"},"juicesAndNectars":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hoteleria y comercios a turistas extranjeros"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["gasolineNearBorder","gasolineBorder","fuelsComplementary","conventionCenters","juicesAndNectars","foreignTourists"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/FirstInstallment"}},"x-scalar-ignore":true},"IvaResicoComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"taxAt16":{"description":"IVA a cargo a la tasa del 16%","type":"integer"},"taxAt8":{"description":"IVA a cargo sujeto al estímulo de la región fronteriza","type":"integer"},"tax":{"description":"Total de IVA a cargo","type":"integer"},"creditable":{"description":"IVA acreditable del periodo","type":"integer"},"netTax":{"description":"Determinación › Cantidad a cargo","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"taxInFavor":{"description":"Impuesto a Favor","type":"integer"},"amountDue":{"description":"DeterminacionPago ISR › Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IvaResicoInvoices":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"activities":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Actividades gravadas a la tasa del 16% (PUE)","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}},"paymentComplements":{"description":"Detalle de Actividades gravadas a la tasa del 16% (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"taxedAt8":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Actividades sujetas al estímulo de la región fronteriza (PUE)","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}},"paymentComplements":{"description":"Detalle de Actividades sujetas al estímulo de la región fronteriza (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"taxedAt0":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Actividades a la tasa del 0% (PUE)","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base 0%"}}},"paymentComplements":{"description":"Detalle de Actividades a la tasa del 0% (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base 0%"}}}}},"exempt":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Actividades exentas (PUE)","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base exento"}}},"paymentComplements":{"description":"Detalle de Actividades exentas (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base exento"}}}}},"notSubject":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de Actividades no objeto del impuesto (PUE)","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados base no objeto"}}},"paymentComplements":{"description":"Detalle de Actividades no objeto del impuesto (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados base no objeto"}}}}}}},"taxAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de IVA a cargo a la tasa del 16%","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","tax","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"}}},"paymentComplements":{"description":"Detalle de IVA a cargo a la tasa del 16% (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"taxAt8":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de IVA a cargo sujeto al estímulo  de la región fronteriza","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","tax","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"}}},"paymentComplements":{"description":"Detalle de IVA a cargo sujeto al estímulo de la región fronteriza (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"withheld":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de IVA retenido","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos IVA"}}},"paymentComplements":{"description":"Detalle de IVA retenido (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos IVA"}}}}},"returns":{"type":"object","additionalProperties":false,"properties":{"sales":{"description":"Detalle de IVA no cobrado por devoluciones, descuentos y bonificaciones de ventas","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","taxAt8","taxAt16"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"taxAt8":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 8%"},"taxAt16":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 16%"}}},"purchases":{"description":"Detalle de IVA por devoluciones, descuentos y bonificaciones en gastos","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","taxAt8","taxAt16"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal - Descuento"},"taxAt8":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"},"taxAt16":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"paid":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Detalle de IVA pagado en gastos y adquisiciones","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","taxAt8","taxAt16"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"taxAt8":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 8%"},"taxAt16":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 16%"}}},"paymentComplements":{"description":"Detalle de IVA pagado en gastos y adquisiciones (Pago)","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","taxAt8","taxAt16"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Importe pagado sin impuestos"},"taxAt8":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"},"taxAt16":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}}},"x-scalar-ignore":true},"IvaResico":{"type":"object","additionalProperties":false,"description":"IVA simplificado de confianza","properties":{"activities":{"$ref":"#/components/schemas/IvaResicoActivities"},"withheld":{"description":"IVA retenido","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"returns":{"$ref":"#/components/schemas/IvaResicoReturns"},"paid":{"$ref":"#/components/schemas/IvaResicoPaid"},"priorBalance":{"description":"Acreditamiento del saldo a favor de periodos anteriores","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"immediateRefund":{"description":"Devolución inmediata obtenida","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"payment":{"$ref":"#/components/schemas/IvaResicoPayment"},"computed":{"$ref":"#/components/schemas/IvaResicoComputed"},"invoices":{"$ref":"#/components/schemas/IvaResicoInvoices"}},"x-scalar-ignore":true},"IvaGeneralInvoices":{"type":"object","additionalProperties":false,"readOnly":true,"properties":{"issued":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Valor de los actos o actividades gravados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"borderRegion":{"description":"Valor de los actos o actividades sujetos al estímulo de la región fronteriza / Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedAt0":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"exempt":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"notSubject":{"description":"Valor de los actos o actividades no objeto del impuesto","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"withheld":{"description":"IVA retenido","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"received":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Total de los actos o actividades pagados a la tasa del 16% / Valor de los actos o actividades pagados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"borderRegion":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza / Valor de los actos o actividades pagados sujetos al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedAt0":{"description":"Total de los actos o actividades pagados a la tasa del 0% / Valor de los actos o actividades pagados a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"exempt":{"description":"Total de actos o actividades pagados por los que no se pagará el IVA (exentos) / Valor de los actos o actividades pagados por los que no se pagará el IVA (exentos)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"activities":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Valor de los actos o actividades gravados a la tasa del 16% pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}},"paymentComplements":{"description":"Valor de los actos o actividades gravados a la tasa del 16% pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"borderRegion":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}},"paymentComplements":{"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"taxedAt0":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 0%"}}},"paymentComplements":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base 0%"}}}}},"exempt":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos) pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base exento"}}},"paymentComplements":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos) pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base exento"}}}}},"notSubject":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Valor de los actos no objeto del impuesto pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base no objeto"}}},"paymentComplements":{"description":"Valor de los actos no objeto del impuesto pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base no objeto"}}}}}}},"taxAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"IVA a cargo a la tasa del 16% pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}},"paymentComplements":{"description":"IVA a cargo a la tasa del 16% pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"taxAtBorderRate":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"IVA a cargo sujeto al estímulo de la región fronteriza pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}},"paymentComplements":{"description":"IVA a cargo sujeto al estímulo de la región fronteriza pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"purchases":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos Trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 16%"}}},"paymentComplements":{"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"borderRegion":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos Trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 8%"}}},"paymentComplements":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"taxedAt0":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Total de los demás actos o actividades pagados a la tasa del 0% de IVA pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 0%"}}},"paymentComplements":{"description":"Total de los demás actos o actividades pagados a la tasa del 0% de IVA pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 0%"}}}}},"exempt":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA exentos"}}},"paymentComplements":{"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA exentos"}}}}}}},"paidAt16":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"IVA de actos o actividades pagados a la tasa del 16% pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 16%"}}},"paymentComplements":{"description":"IVA de actos o actividades pagados a la tasa del 16% pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 16%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 16%"}}}}},"paidAtBorderRate":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"IVA pagado sujeto al estímulo de la región fronteriza pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos Trasladados IVA 8%"}}},"paymentComplements":{"description":"IVA pagado sujeto al estímulo de la región fronteriza pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","paid","base","tax"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"paid":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos / Importe pagado sin impuestos"},"base":{"type":"integer","minimum":0,"description":"Impuestos trasladados Base IVA 8%"},"tax":{"type":"integer","minimum":0,"description":"Impuestos trasladados IVA 8%"}}}}},"withheld":{"type":"object","additionalProperties":false,"properties":{"singlePayment":{"description":"IVA retenido pago en una sola exhibición","type":"object","additionalProperties":false,"required":["cancelled","valid","subtotal","discount","net","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"subtotal":{"type":"integer","minimum":0,"description":"Subtotal"},"discount":{"type":"integer","minimum":0,"description":"Descuento"},"net":{"type":"integer","minimum":0,"description":"Subtotal – Descuento"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos IVA"}}},"paymentComplements":{"description":"IVA retenido pago corresponde al mes","type":"object","additionalProperties":false,"required":["cancelled","valid","collected","withheld"],"properties":{"cancelled":{"type":"integer","minimum":0,"description":"Número de facturas Canceladas"},"valid":{"type":"integer","minimum":0,"description":"Número de facturas Vigentes"},"collected":{"type":"integer","minimum":0,"description":"Ingresos cobrados sin impuestos"},"withheld":{"type":"integer","minimum":0,"description":"Impuestos retenidos IVA"}}}}}},"x-scalar-ignore":true},"IvaGeneralActivities":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Valor de los actos o actividades gravados a la tasa del 16%","type":"object","additionalProperties":false,"properties":{"total":{"description":"Valor de los actos o actividades gravados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"interest":{"description":"Intereses cobrados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"royalties":{"description":"Regalías entre partes relacionadas a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros actos o actividades gravados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"borderRegion":{"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza","type":"object","additionalProperties":false,"properties":{"total":{"description":"Valor de los actos o actividades gravados sujetos al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northInterest":{"description":"Intereses cobrados sujetos al estímulo de la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northRoyalties":{"description":"Regalías entre partes relacionadas sujetos al estímulo de la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northOther":{"description":"Otros actos o actividades gravados sujetos al estímulo de la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southInterest":{"description":"Intereses cobrados sujetos al estímulo de la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southRoyalties":{"description":"Regalías entre partes relacionadas sujetos al estímulo de la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southOther":{"description":"Otros actos o actividades gravados sujetos al estímulo de la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"export":{"description":"Valor de los actos o actividades gravados a la tasa del 0% exportación","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"taxedAt0":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros","type":"object","additionalProperties":false,"properties":{"total":{"description":"Valor de los actos o actividades gravados a la tasa del 0% otros","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"primarySector":{"description":"Actividades agrícolas, ganaderas, silvícolas o pesqueras gravadas a la tasa del 0% / Actividades agrícolas, ganaderas, silvícolas o pesqueras a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros actos o actividades gravados a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"exempt":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos)","type":"object","additionalProperties":false,"properties":{"total":{"description":"Valor de los actos o actividades por los que no se deba pagar el impuesto (exentos)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"landAndHousing":{"description":"Enajenación de suelo y construcciones adheridas al suelo, destinadas o utilizadas para casa habitación","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"books":{"description":"Enajenación de libros, periódicos y revistas (no editados por el contribuyente)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"authorsRoyalties":{"description":"Regalías cobradas por autores","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"usedGoods":{"description":"Enajenación de bienes muebles usados, excepto los enajenados por empresas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"lotteryTickets":{"description":"Enajenación de billetes y demás comprobantes de loterías, rifas, sorteos o juegos con apuestas y concursos de toda clase","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"education":{"description":"Servicios de enseñanza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"publicTransport":{"description":"Servicio de transporte público terrestre de personas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"derivatives":{"description":"Operaciones financieras derivadas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"eventTickets":{"description":"Venta de boletos para espectáculos públicos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"medicalServices":{"description":"Servicios profesionales de medicina","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"housingLeases":{"description":"Uso o goce temporal de inmuebles para casa habitación y por fincas para fines agrícolas o ganaderos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros ingresos exentos de IVA","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"notSubject":{"description":"Valor de los actos o actividades no objeto del impuesto","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaGeneralAdjustments":{"type":"object","additionalProperties":false,"properties":{"toRepay":{"description":"Cantidad actualizada a reintegrarse derivada del ajuste","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"toCredit":{"description":"Monto acreditable actualizado a incrementar derivado del ajuste","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaGeneralPurchases":{"type":"object","additionalProperties":false,"properties":{"taxedAt16":{"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA / Valor de los actos o actividades pagados a la tasa del 16%","type":"object","additionalProperties":false,"properties":{"total":{"description":"Total de los actos o actividades pagados a la tasa del 16% de IVA / Valor de los actos o actividades pagados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"interest":{"description":"Intereses pagados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"royalties":{"description":"Regalías pagadas entre partes relacionadas a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros actos o actividades pagados a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"borderRegion":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza / Valor de los actos o actividades pagados sujetos al estímulo de la región fronteriza","type":"object","additionalProperties":false,"properties":{"total":{"description":"Total de los actos o actividades pagados sujetos al estímulo de la región fronteriza / Valor de los actos o actividades pagados sujetos al estímulo de la región fronteriza","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northInterest":{"description":"Intereses pagados en la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northRoyalties":{"description":"Regalías pagadas entre partes relacionadas en la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"northOther":{"description":"Otros actos o actividades pagados en la RFN","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southInterest":{"description":"Intereses pagados en la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southRoyalties":{"description":"Regalías pagadas entre partes relacionadas en la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"southOther":{"description":"Otros actos o actividades pagados en la RFS","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"imports":{"description":"Total de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16% de IVA / Valor de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%","type":"object","additionalProperties":false,"properties":{"total":{"description":"Total de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16% de IVA / Valor de los actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"intangibles":{"description":"Importación de bienes intangibles a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"intangiblesUse":{"description":"Importación de uso o goce temporal de bienes intangibles a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"services":{"description":"Importación de servicios a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros actos o actividades pagados en la importación de bienes y servicios a la tasa del 16%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"taxedAt0":{"description":"Total de los demás actos o actividades pagados a la tasa del 0% de IVA / Valor de los demás actos o actividades pagados a la tasa del 0%","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"exempt":{"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) / Valor de los actos o actividades pagados por los que no se pagará el IVA (exentos)","type":"object","additionalProperties":false,"properties":{"total":{"description":"Total de los actos o actividades pagados por los que no se pagará el IVA (exentos) / Valor de los actos o actividades pagados por los que no se pagará el IVA (exentos)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"landAndHousing":{"description":"Adquisición de suelo y construcciones adheridas al suelo, destinadas o utilizadas para casa habitación","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"books":{"description":"Adquisición de libros, periódicos o revistas (no editados por el contribuyente)","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"authorsRoyalties":{"description":"Regalías pagadas a los autores","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"usedGoods":{"description":"Adquisición de bienes muebles usados excepto los adquiridos de empresas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"publicTransport":{"description":"Servicio de transporte público terrestre de personas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"medicalServices":{"description":"Servicios profesionales de medicina","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"agriculturalInsurance":{"description":"Aseguramiento contra riesgos agropecuarios","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"farmLeases":{"description":"Uso o goce temporal de fincas para fines agrícolas o ganaderos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"imports":{"description":"Actos o actividades pagados en la importación de bienes y servicios exentos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Otros actos o actividades pagados exentos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}}},"x-scalar-ignore":true},"IvaGeneralPaid":{"type":"object","additionalProperties":false,"properties":{"taxedActivities":{"type":"object","additionalProperties":false,"properties":{"purchases":{"description":"IVA trasladado por adquisiciones de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes que se utilizan exclusivamente para realizar actos o actividades gravados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"investments":{"description":"IVA trasladado por la adquisición de inversiones destinadas exclusivamente para realizar actos o actividades gravados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"importedPurchases":{"description":"IVA pagado en la importación por adquisición de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes que se utilizan exclusivamente para realizar actos o actividades gravados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"importedInvestments":{"description":"IVA pagado por la importación de inversiones destinadas exclusivamente para realizar actos o actividades gravados","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"exemptActivities":{"type":"object","additionalProperties":false,"properties":{"purchases":{"description":"IVA trasladado o pagado en la importación por adquisición de bienes distintos de las inversiones, adquisición de servicios o por el uso o goce temporal de bienes destinados exclusivamente para realizar actos o actividades por los que no se está obligado al pago del impuesto / IVA correspondiente a actos o actividades por los que no se está obligado al pago del impuesto","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"investments":{"description":"IVA trasladado o pagado en la importación de inversiones destinadas exclusivamente para realizar actos o actividades por los que no se está obligado al pago del impuesto","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"mixed":{"type":"object","additionalProperties":false,"properties":{"method":{"description":"Selecciona la proporción de IVA que aplicarás","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"anyOf":[{"type":"string","oneOf":[{"const":"1","title":"Art. 5-B de la LIVA"},{"const":"2","title":"Art. 5 de la LIVA"}]},{"type":"null"}],"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"string","oneOf":[{"const":"1","title":"Art. 5-B de la LIVA"},{"const":"2","title":"Art. 5 de la LIVA"}]},{"type":"null"}],"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"proportion":{"description":"Proporción de IVA","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["number","null"],"minimum":0,"maximum":1,"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["number","null"],"minimum":0,"maximum":1,"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}}}}},"x-scalar-ignore":true},"IvaGeneralOtherAmounts":{"type":"object","additionalProperties":false,"properties":{"due":{"description":"Otras cantidades a cargo del contribuyente","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"inFavor":{"description":"Otras cantidades a favor del contribuyente","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"IvaGeneralPayment":{"type":"object","additionalProperties":false,"properties":{"charges":{"$ref":"#/components/schemas/Charges"},"offsets":{"$ref":"#/components/schemas/Offsets"},"incentives":{"description":"¿Tienes estímulos por aplicar?","type":"object","required":["sat","declared","source","editable","options"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"juicesAndNectars":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros"},"conventionCenters":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"gasolineBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en zona fronteriza","description":"Estímulo a gasolinas en zona fronteriza"},"gasolineNearBorder":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo a gasolinas en regiones cercanas a zona fronteriza","description":"Estímulo a gasolinas en regiones cercanas a zona fronteriza"},"fuelsComplementary":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo complementario combustibles","description":"Estímulo complementario combustibles"},"juicesAndNectars":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber","description":"Estímulo fiscal por la importación o enajenación de jugos, néctares, concentrados de frutas o de verduras y de productos para beber"},"foreignTourists":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros","description":"Estímulo fiscal por la prestación de servicios de hotelería y conexos a turistas extranjeros"},"conventionCenters":{"type":"integer","exclusiveMinimum":0,"title":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero","description":"Estímulo fiscal por el uso temporal de centros de convenciones y de exposiciones a residentes en el extranjero"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."},"options":{"type":"array","items":{"type":"string","enum":["gasolineBorder","gasolineNearBorder","fuelsComplementary","juicesAndNectars","foreignTourists","conventionCenters"]},"description":"The concepts that SAT's form offers in this declaration. A request can send only these."}}},"recentPayment":{"$ref":"#/components/schemas/RecentPayment"},"amountPaid":{"description":"Monto pagado con anterioridad","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"identifiedPayments":{"$ref":"#/components/schemas/IdentifiedPayments"},"unmatchedPayments":{"$ref":"#/components/schemas/UnmatchedPayments"},"unmatchedPaymentOptions":{"$ref":"#/components/schemas/UnmatchedPaymentOptions"},"installments":{"$ref":"#/components/schemas/Installments"}},"x-scalar-ignore":true},"IvaGeneralComputed":{"type":"object","additionalProperties":false,"description":"Computed with the form's rules. Output only.","readOnly":true,"properties":{"recentPaymentAmount":{"description":"Importe pagado en las últimas 48 horas","type":"integer"},"taxAt16":{"description":"IVA a cargo a la tasa del 16%","type":"integer"},"taxAtBorderRate":{"description":"IVA a cargo sujeto al estímulo de la región fronteriza","type":"integer"},"tax":{"description":"Total de IVA a cargo","type":"integer"},"paid":{"description":"Total de IVA trasladado al contribuyente (Efectivamente pagado) / IVA trasladado al contribuyente (efectivamente pagado)","type":"integer"},"mixedUse":{"description":"IVA de bienes utilizados indistintamente para realizar actos o actividades gravados y actos o actividades por los que no se está obligado al pago del impuesto / IVA pagado utilizado indistintamente para realizar actos o actividades gravados y actos o actividades por los que no se está obligado al pago del impuesto","type":"integer"},"creditable":{"description":"Total de IVA acreditable","type":"integer"},"balanceDue":{"description":"Determinación › Cantidad a cargo","type":"integer"},"balanceInFavor":{"description":"Saldo a favor","type":"integer"},"taxDue":{"description":"Impuesto a cargo","type":"integer"},"taxInFavor":{"description":"Impuesto a favor","type":"integer"},"amountDue":{"description":"DeterminacionPago ISR › Cantidad a cargo","type":"integer"},"amountInFavor":{"description":"Cantidad a favor","type":"integer"},"amountToPay":{"description":"Cantidad a pagar","type":"integer"}},"x-scalar-ignore":true},"IvaGeneral":{"type":"object","additionalProperties":false,"description":"Impuesto al Valor Agregado. Personas morales / Impuesto al Valor Agregado. Personas físicas","properties":{"invoices":{"$ref":"#/components/schemas/IvaGeneralInvoices"},"activities":{"$ref":"#/components/schemas/IvaGeneralActivities"},"adjustments":{"$ref":"#/components/schemas/IvaGeneralAdjustments"},"purchases":{"$ref":"#/components/schemas/IvaGeneralPurchases"},"paid":{"$ref":"#/components/schemas/IvaGeneralPaid"},"withheld":{"description":"IVA retenido","type":"object","additionalProperties":false,"properties":{"total":{"description":"IVA retenido","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"onSales":{"description":"Por enajenación de bienes","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"onOther":{"description":"Por otras operaciones","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}}},"otherAmounts":{"$ref":"#/components/schemas/IvaGeneralOtherAmounts"},"immediateRefund":{"description":"Devolución inmediata obtenida","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"priorBalance":{"description":"Detalle del acreditamiento del saldo a favor del Impuesto al Valor Agregado de periodos anteriores.","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["periodicity","year","period","amount","declarationType","operationNumber","filedOn","originalBalance","remaining"],"properties":{"periodicity":{"type":"string","oneOf":[{"const":"M","title":"1-Mensual"},{"const":"S","title":"2-Semestral"},{"const":"T","title":"3-Trimestral"}],"description":"Periodicidad"},"year":{"$ref":"#/components/schemas/SatCatalog10EjerciciosInmediatosAnteriores","description":"Ejercicio"},"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodos"},{"$ref":"#/components/schemas/SatCatalogIVAPFPeriodo"}]},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo por aplicar"},"declarationType":{"type":"string","oneOf":[{"const":"001","title":"Normal"},{"const":"002","title":"Complementaria"},{"const":"003","title":"Normal por Corrección Fiscal"},{"const":"004","title":"Complementaria por Corrección Fiscal"},{"const":"005","title":"Complementaria por Dictamen"}],"description":"Tipo de declaración"},"operationNumber":{"type":"string","description":"Número de operación"},"filedOn":{"type":"string","format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalBalance":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto del saldo a favor original"},"remaining":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Remanente histórico antes de la aplicación"}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["periodicity","year","period","amount","declarationType","operationNumber","filedOn","originalBalance","remaining"],"properties":{"periodicity":{"type":"string","oneOf":[{"const":"M","title":"1-Mensual"},{"const":"S","title":"2-Semestral"},{"const":"T","title":"3-Trimestral"}],"description":"Periodicidad"},"year":{"$ref":"#/components/schemas/SatCatalog10EjerciciosInmediatosAnteriores","description":"Ejercicio"},"period":{"description":"Periodo","anyOf":[{"$ref":"#/components/schemas/SatCatalogPeriodos"},{"$ref":"#/components/schemas/SatCatalogIVAPFPeriodo"}]},"amount":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Saldo por aplicar"},"declarationType":{"type":"string","oneOf":[{"const":"001","title":"Normal"},{"const":"002","title":"Complementaria"},{"const":"003","title":"Normal por Corrección Fiscal"},{"const":"004","title":"Complementaria por Corrección Fiscal"},{"const":"005","title":"Complementaria por Dictamen"}],"description":"Tipo de declaración"},"operationNumber":{"type":"string","description":"Número de operación"},"filedOn":{"type":"string","format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalBalance":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Monto del saldo a favor original"},"remaining":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Remanente histórico antes de la aplicación"}}},"description":"What will be filed. Null when nothing is declared yet, for example for a question with no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}}},"payment":{"$ref":"#/components/schemas/IvaGeneralPayment"},"computed":{"$ref":"#/components/schemas/IvaGeneralComputed"}},"x-scalar-ignore":true},"ChargesInput":{"type":["object","null"],"additionalProperties":false,"properties":{"inflationAdjustment":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Parte actualizada"},"surcharges":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Recargos"},"fines":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Multa por corrección"},"other":{"type":["integer","null"],"minimum":0,"maximum":100000000000000,"description":"Accesorios distintos de las multas"}},"x-scalar-ignore":true},"OffsetsInput":{"description":"¿Tienes compensaciones por aplicar?\n\nThe API cannot declare its rows yet: a row fails with `unsupported_form`, so only `false` (*No*) can be sent.","anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["balanceType","concept","amount"],"properties":{"balanceType":{"type":"string","oneOf":[{"const":"PDI","title":"Pago de lo indebido"},{"const":"SAF","title":"Saldo a favor"}],"description":"Tipo"},"periodicity":{"$ref":"#/components/schemas/SatCatalogPeriodicidad","description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodo","description":"Periodo"},"year":{"type":["string","null"],"description":"Ejercicio"},"accruedOn":{"type":["string","null"],"format":"date","description":"Fecha de causación"},"operationNumber":{"type":["string","null"],"description":"Número de operación"},"concept":{"$ref":"#/components/schemas/SatCatalogObligacion","description":"Concepto de pago"},"amount":{"type":"integer","minimum":0,"description":"Saldo a aplicar"},"declarationType":{"$ref":"#/components/schemas/SatCatalogTipoDeDeclaracion","description":"Tipo de declaración"},"originalBalance":{"type":["integer","null"],"minimum":0,"description":"Monto del saldo a favor original"},"originalFiledOn":{"type":["string","null"],"format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalOperationNumber":{"type":["string","null"],"description":"Número de operación"},"remaining":{"type":["integer","null"],"minimum":0,"description":"Remanente histórico antes de la aplicación"},"remainingAdjusted":{"type":["integer","null"],"minimum":0,"description":"Remanente actualizado antes de la aplicación"}}},"minItems":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"x-scalar-ignore":true},"RecentPaymentInput":{"description":"¿Realizó en las últimas 48 horas un pago para este concepto?","anyOf":[{"type":"object","additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"x-scalar-ignore":true},"UnmatchedPaymentsInput":{"description":"¿Deseas agregar una línea de captura no considerada?","anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["reference","paidOn","amount"],"properties":{"reference":{"type":"string","maxLength":24,"description":"Línea de captura"},"paidOn":{"type":"string","format":"date","description":"Fecha del pago"},"amount":{"type":"integer","minimum":0,"maximum":999999999999,"description":"Monto pagado"},"formNumber":{"type":["string","null"],"description":"Número del formato de pago"},"bank":{"$ref":"#/components/schemas/SatCatalogBancoPagoDeLineaDeCaptura","description":"Banco receptor del pago"},"bankOperation":{"type":["string","null"],"description":"No. de operación del pago"},"paymentKey":{"type":["string","null"],"description":"Llave de pago"}}},"minItems":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"x-scalar-ignore":true},"InstallmentsInput":{"description":"¿Opta por pagar en parcialidades?","anyOf":[{"type":"object","additionalProperties":false,"required":["type","count"],"properties":{"type":{"type":"string","oneOf":[{"const":"1","title":"Pago en parcialidades"},{"const":"2","title":"Pago diferido"}],"description":"Tipo de solicitud"},"count":{"$ref":"#/components/schemas/SatCatalogNumeroASolicitar","description":"Número a solicitar"},"firstPayment":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"x-scalar-ignore":true},"ChargesWithoutOtherInput":{"type":["object","null"],"additionalProperties":false,"properties":{"inflationAdjustment":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Parte actualizada"},"surcharges":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Recargos"},"fines":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Multa por corrección"}},"x-scalar-ignore":true},"FirstInstallmentInput":{"description":"¿Opta por pagar en parcialidades?","anyOf":[{"type":"object","additionalProperties":false,"properties":{"firstPayment":{"type":["integer","null"],"minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}},"minProperties":1},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"x-scalar-ignore":true},"Charges":{"type":"object","additionalProperties":false,"properties":{"inflationAdjustment":{"description":"Parte actualizada","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"surcharges":{"description":"Recargos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"fines":{"description":"Multa por corrección","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"other":{"description":"Accesorios distintos de las multas","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"Offsets":{"description":"¿Tienes compensaciones por aplicar?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["balanceType","concept","amount"],"properties":{"balanceType":{"type":"string","oneOf":[{"const":"PDI","title":"Pago de lo indebido"},{"const":"SAF","title":"Saldo a favor"}],"description":"Tipo"},"periodicity":{"$ref":"#/components/schemas/SatCatalogPeriodicidad","description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodo","description":"Periodo"},"year":{"type":"string","description":"Ejercicio"},"accruedOn":{"type":"string","format":"date","description":"Fecha de causación"},"operationNumber":{"type":"string","description":"Número de operación"},"concept":{"$ref":"#/components/schemas/SatCatalogObligacion","description":"Concepto de pago"},"amount":{"type":"integer","minimum":0,"description":"Saldo a aplicar"},"declarationType":{"$ref":"#/components/schemas/SatCatalogTipoDeDeclaracion","description":"Tipo de declaración"},"originalBalance":{"type":"integer","minimum":0,"description":"Monto del saldo a favor original"},"originalFiledOn":{"type":"string","format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalOperationNumber":{"type":"string","description":"Número de operación"},"remaining":{"type":"integer","minimum":0,"description":"Remanente histórico antes de la aplicación"},"remainingAdjusted":{"type":"integer","minimum":0,"description":"Remanente actualizado antes de la aplicación"}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["balanceType","concept","amount"],"properties":{"balanceType":{"type":"string","oneOf":[{"const":"PDI","title":"Pago de lo indebido"},{"const":"SAF","title":"Saldo a favor"}],"description":"Tipo"},"periodicity":{"$ref":"#/components/schemas/SatCatalogPeriodicidad","description":"Periodicidad"},"period":{"$ref":"#/components/schemas/SatCatalogPeriodo","description":"Periodo"},"year":{"type":"string","description":"Ejercicio"},"accruedOn":{"type":"string","format":"date","description":"Fecha de causación"},"operationNumber":{"type":"string","description":"Número de operación"},"concept":{"$ref":"#/components/schemas/SatCatalogObligacion","description":"Concepto de pago"},"amount":{"type":"integer","minimum":0,"description":"Saldo a aplicar"},"declarationType":{"$ref":"#/components/schemas/SatCatalogTipoDeDeclaracion","description":"Tipo de declaración"},"originalBalance":{"type":"integer","minimum":0,"description":"Monto del saldo a favor original"},"originalFiledOn":{"type":"string","format":"date","description":"Fecha en que se presentó la declaración del saldo a favor"},"originalOperationNumber":{"type":"string","description":"Número de operación"},"remaining":{"type":"integer","minimum":0,"description":"Remanente histórico antes de la aplicación"},"remainingAdjusted":{"type":"integer","minimum":0,"description":"Remanente actualizado antes de la aplicación"}}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}},"x-scalar-ignore":true},"RecentPayment":{"description":"¿Realizó en las últimas 48 horas un pago para este concepto?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"required":["paidOn"],"properties":{"paidOn":{"type":"string","format":"date","description":"Fecha del pago realizado en las últimas 48 horas"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}},"x-scalar-ignore":true},"IdentifiedPayments":{"description":"Línea de captura","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["reference","declarationNumber","bank","paidOn","bankOperation","paymentKey","amount"],"properties":{"reference":{"type":["string","null"],"description":"Línea de captura"},"declarationNumber":{"type":["string","null"],"description":"Número de declaración"},"bank":{"description":"Banco receptor del pago","anyOf":[{"$ref":"#/components/schemas/SatCatalogBancoPagoDeLineaDeCaptura"},{"type":"null"}]},"paidOn":{"type":["string","null"],"format":"date","description":"Fecha de pago"},"bankOperation":{"type":["string","null"],"description":"No. de operación del pago"},"paymentKey":{"type":["string","null"],"description":"Llave de pago"},"amount":{"type":["integer","null"],"minimum":0,"description":"Monto pagado"}}},"x-scalar-ignore":true},"UnmatchedPayments":{"description":"¿Deseas agregar una línea de captura no considerada?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["array","null"],"items":{"type":"object","additionalProperties":false,"required":["reference","paidOn","amount"],"properties":{"reference":{"type":"string","maxLength":24,"description":"Línea de captura"},"paidOn":{"type":"string","format":"date","description":"Fecha del pago"},"amount":{"type":"integer","minimum":0,"maximum":999999999999,"description":"Monto pagado"},"formNumber":{"type":"string","description":"Número del formato de pago"},"bank":{"$ref":"#/components/schemas/SatCatalogBancoPagoDeLineaDeCaptura","description":"Banco receptor del pago"},"bankOperation":{"type":"string","description":"No. de operación del pago"},"paymentKey":{"type":"string","description":"Llave de pago"}}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"array","items":{"type":"object","additionalProperties":false,"required":["reference","paidOn","amount"],"properties":{"reference":{"type":"string","maxLength":24,"description":"Línea de captura"},"paidOn":{"type":"string","format":"date","description":"Fecha del pago"},"amount":{"type":"integer","minimum":0,"maximum":999999999999,"description":"Monto pagado"},"formNumber":{"type":"string","description":"Número del formato de pago"},"bank":{"$ref":"#/components/schemas/SatCatalogBancoPagoDeLineaDeCaptura","description":"Banco receptor del pago"},"bankOperation":{"type":"string","description":"No. de operación del pago"},"paymentKey":{"type":"string","description":"Llave de pago"}}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}},"x-scalar-ignore":true},"UnmatchedPaymentOptions":{"description":"Línea de captura ADR Cache","readOnly":true,"type":"array","items":{"type":"object","additionalProperties":false,"required":["reference","formNumber","bank","paidOn","bankOperation","paymentKey","amount"],"properties":{"reference":{"type":["string","null"],"description":"Línea de captura"},"formNumber":{"type":["string","null"],"description":"Número del documento de pago"},"bank":{"description":"Banco receptor del pago","anyOf":[{"$ref":"#/components/schemas/SatCatalogBancoPagoDeLineaDeCaptura"},{"type":"null"}]},"paidOn":{"type":["string","null"],"format":"date","description":"Fecha del pago"},"bankOperation":{"type":["string","null"],"description":"Número de operación del pago"},"paymentKey":{"type":["string","null"],"description":"Llave de pago"},"amount":{"type":["integer","null"],"minimum":0,"description":"Monto pagado"}}},"x-scalar-ignore":true},"Installments":{"description":"¿Opta por pagar en parcialidades?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"required":["type","count"],"properties":{"type":{"type":"string","oneOf":[{"const":"1","title":"Pago en parcialidades"},{"const":"2","title":"Pago diferido"}],"description":"Tipo de solicitud"},"count":{"$ref":"#/components/schemas/SatCatalogNumeroASolicitar","description":"Número a solicitar"},"firstPayment":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"required":["type","count"],"properties":{"type":{"type":"string","oneOf":[{"const":"1","title":"Pago en parcialidades"},{"const":"2","title":"Pago diferido"}],"description":"Tipo de solicitud"},"count":{"$ref":"#/components/schemas/SatCatalogNumeroASolicitar","description":"Número a solicitar"},"firstPayment":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}},"x-scalar-ignore":true},"ChargesWithoutOther":{"type":"object","additionalProperties":false,"properties":{"inflationAdjustment":{"description":"Parte actualizada","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"surcharges":{"description":"Recargos","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]},"fines":{"description":"Multa por corrección","allOf":[{"$ref":"#/components/schemas/DeclaredAmount"}]}},"x-scalar-ignore":true},"FirstInstallment":{"description":"¿Opta por pagar en parcialidades?","type":"object","required":["sat","declared","source","editable"],"properties":{"sat":{"type":["object","null"],"additionalProperties":false,"properties":{"firstPayment":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}},"description":"What SAT preloaded. Null when SAT has no value for it. Always null in a draft read from SAT."},"declared":{"anyOf":[{"type":"object","additionalProperties":false,"properties":{"firstPayment":{"type":"integer","minimum":0,"maximum":99999999999999,"description":"Importe de la primera parcialidad"}}},{"type":"boolean","const":false,"description":"Answers *No*."},{"type":"null"}],"description":"What will be filed. `false` when the question is answered *No*. Null while it has no answer."},"source":{"$ref":"#/components/schemas/ValueSource"},"editable":{"type":"boolean","description":"`true` when a request can send this value. `false` when it is read-only."}},"x-scalar-ignore":true},"SatCatalogPeriodoPPRESICOPF":{"type":"string","oneOf":[{"const":"P2","title":"Enero"},{"const":"P3","title":"Febrero"},{"const":"P4","title":"Marzo"},{"const":"P5","title":"Abril"},{"const":"P6","title":"Mayo"},{"const":"P7","title":"Junio"},{"const":"P8","title":"Julio"},{"const":"P9","title":"Agosto"},{"const":"P10","title":"Septiembre"},{"const":"P11","title":"Octubre"},{"const":"P12","title":"Noviembre"},{"const":"P13","title":"Diciembre"},{"const":"P15","title":"Enero - Marzo"},{"const":"P16","title":"Abril - Junio"},{"const":"P17","title":"Julio - Septiembre"},{"const":"P18","title":"Octubre - Diciembre"},{"const":"P14","title":"Del ejercicio"}],"description":"Options from the *Periodo PP RESICO PF* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogPeriodicidad":{"type":"string","oneOf":[{"const":"M","title":"1-Mensual"},{"const":"B","title":"2-Bimestral"},{"const":"T","title":"3-Trimestral"},{"const":"Q","title":"4-Cuatrimestral"},{"const":"S","title":"5-Semestral (A)"},{"const":"L","title":"6-Semestral (B) Liquidación"},{"const":"J","title":"7-Ajuste"},{"const":"Y","title":"8-Del Ejercicio"},{"const":"N","title":"9-Sin período"}],"description":"Options from the *Periodicidad* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogPeriodo":{"type":"string","oneOf":[{"const":"001","title":"Enero"},{"const":"002","title":"Febrero"},{"const":"003","title":"Marzo"},{"const":"004","title":"Abril"},{"const":"005","title":"Mayo"},{"const":"006","title":"Junio"},{"const":"007","title":"Julio"},{"const":"008","title":"Agosto"},{"const":"009","title":"Septiembre"},{"const":"010","title":"Octubre"},{"const":"011","title":"Noviembre"},{"const":"012","title":"Diciembre"},{"const":"013","title":"1° Enero-Marzo"},{"const":"014","title":"2° Abril-Junio"},{"const":"015","title":"3° Julio-Septiembre"},{"const":"016","title":"4° Octubre-Diciembre"},{"const":"017","title":"1° Enero-Abril"},{"const":"018","title":"2° Mayo-Agosto"},{"const":"019","title":"3° Septiembre-Diciembre"},{"const":"020","title":"1° Enero-Junio"},{"const":"021","title":"2° Julio-Diciembre"},{"const":"022","title":"Enero-Junio"},{"const":"023","title":"Febrero-Julio"},{"const":"024","title":"Marzo-Agosto"},{"const":"025","title":"Abril-Septiembre"},{"const":"026","title":"Mayo-Octubre"},{"const":"027","title":"Junio-Noviembre"},{"const":"028","title":"Julio-Diciembre"},{"const":"029","title":"Agosto-Enero"},{"const":"030","title":"Septiembre-Febrero"},{"const":"031","title":"Octubre-Marzo"},{"const":"032","title":"Noviembre-Abril"},{"const":"033","title":"Diciembre-Mayo"},{"const":"034","title":"Ajuste del Ejercicio"},{"const":"035","title":"Del Ejercicio"},{"const":"036","title":"Enero-Febrero"},{"const":"037","title":"Marzo-Abril"},{"const":"038","title":"Mayo-Junio"},{"const":"039","title":"Julio-Agosto"},{"const":"040","title":"Septiembre-Octubre"},{"const":"041","title":"Noviembre-Diciembre"},{"const":"042","title":"Del Ejercicio por Liquidación"},{"const":"043","title":"Del Ejercicio por Defunción"},{"const":"044","title":"Del Ejercicio por Terminación Anticipada"},{"const":"048","title":"Última del ejercicio por liquidación"},{"const":"049","title":"Liquidación por cambio de residencia"},{"const":"099","title":"Sin Periodo"}],"description":"Options from the *Periodo* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogObligacion":{"type":"string","oneOf":[{"const":"0101","title":"ISR personas morales"},{"const":"0102","title":"ISR personas morales, régimen simplificado. Impuesto propio"},{"const":"0103","title":"ISR personas morales, régimen simplificado. Impuesto de sus integrantes"},{"const":"0104","title":"ISR por consolidación"},{"const":"0105","title":"ISR por dividendos"},{"const":"0106","title":"ISR por fondos de pensiones o jubilaciones y primas de antigüedad"},{"const":"0107","title":"ISR personas físicas. Actividad empresarial y profesional"},{"const":"0108","title":"ISR personas físicas. Actividad empresarial. Régimen intermedio para la federación"},{"const":"0110","title":"ISR personas físicas. Arrendamiento de inmuebles (uso o goce)"},{"const":"0111","title":"ISR personas físicas. De los demás ingresos"},{"const":"0112","title":"ISR retenciones por salarios"},{"const":"0113","title":"ISR retenciones por asimilados a salarios"},{"const":"0114","title":"ISR retenciones por servicios profesionales"},{"const":"0115","title":"ISR por pagos por cuenta de terceros o retenciones por arrendamiento de inmuebles"},{"const":"0116","title":"ISR retenciones por intereses"},{"const":"0117","title":"ISR otras retenciones"},{"const":"0118","title":"ISR retenciones por pagos al extranjero"},{"const":"0119","title":"ISR personas físicas"},{"const":"0120","title":"ISR personas físicas. Salarios"},{"const":"0121","title":"ISR enajenación de bienes"},{"const":"0122","title":"ISR fedatarios públicos y retenciones. Enajenación de bienes para la federación"},{"const":"0123","title":"ISR personas físicas. Adquisición de bienes"},{"const":"0124","title":"ISR fedatarios públicos. Adquisición de bienes"},{"const":"0125","title":"ISR retenciones por premios"},{"const":"0126","title":"ISR por ingresos sujetos a regímenes fiscales preferentes"},{"const":"0130","title":"ISR diferido por consolidación"},{"const":"0131","title":"ISR Personas Morales. Régimen Opcional para Grupos de Sociedades"},{"const":"0132","title":"ISR Régimen de Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras. Impuesto Propio"},{"const":"0133","title":"ISR Régimen de Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras. Impuesto Propio"},{"const":"0134","title":"ISR Personas Morales. Régimen de Actividades Agrícolas, Ganaderas, Silvícolas y Pesqueras. Impuesto de sus Integrantes"},{"const":"0135","title":"ISR Personas Morales. Régimen de los Coordinados. Impuesto Propio"},{"const":"0136","title":"ISR Personas Morales. Régimen de los Coordinados. Impuesto de sus Integrantes"},{"const":"0137","title":"ISR personas físicas régimen de incorporación fiscal"},{"const":"0138","title":"ISR retenciones por dividendos"},{"const":"0139","title":"ISR por la enajenación de acciones en bolsa de valores"},{"const":"0140","title":"ISR de contratistas y asignatarios de hidrocarburos"},{"const":"0142","title":"Declaración del ISR por Ingresos de Inversiones en el Extranjero / F100"},{"const":"0145","title":"ISR Opción de acumulación de ingresos por personas morales"},{"const":"0145RF","title":"ISR Opción de acumulación de ingresos por personas morales RFN"},{"const":"0147","title":"ISR personas físicas. Actividad empresarial"},{"const":"0147RF","title":"ISR personas físicas. Actividad empresarial RFN"},{"const":"0148","title":"ISR personas físicas. Servicios profesionales"},{"const":"0149","title":"ISR personas morales modalidad de albergue"},{"const":"0158","title":"ISR retenciones por el uso de plataformas tecnológicas"},{"const":"0159","title":"ISR personas morales región fronteriza (RF)"},{"const":"0161","title":"ISR personas físicas. Actividad empresarial y profesional"},{"const":"0162","title":"ISR personas físicas plataformas tecnológicas"},{"const":"0163","title":"ISR retenciones por el uso de plataformas tecnológicas"},{"const":"0164","title":"ISR personas morales"},{"const":"0164RF","title":"ISR personas morales RFN"},{"const":"0165","title":"ISR de contratistas y asignatarios de hidrocarburos"},{"const":"0167","title":"ISR simplificado de confianza. Personas morales"},{"const":"0167RF","title":"ISR simplificado de confianza. Personas morales región fronteriza (RF)"},{"const":"0168","title":"ISR simplificado de confianza. Personas físicas"},{"const":"0169","title":"ISR recargos por disminución de coeficiente de utilidad"},{"const":"0170","title":"ISR personas morales. PODEBI"},{"const":"0171","title":"ISR simplificado de confianza. Personas morales. PODEBI"},{"const":"0172","title":"ISR personas físicas actividad empresarial. PODEBI"},{"const":"0173","title":"ISR personas morales. POINBI"},{"const":"0174","title":"ISR simplificado de confianza. Personas morales. POINBI"},{"const":"0175","title":"ISR personas físicas actividad empresarial. POINBI"},{"const":"0176","title":"ISR personas morales. Chetumal"},{"const":"0177","title":"ISR personas físicas actividad empresarial. Chetumal"},{"const":"0178","title":"ISR simplificado de confianza. Personas físicas. Chetumal"},{"const":"0179","title":"ISR personas morales. PODECOBI"},{"const":"0180","title":"ISR personas físicas. Actividad empresarial. PODECOBI"},{"const":"0181","title":"ISR personas morales. PODECIBI"},{"const":"0182","title":"ISR personas físicas. Actividad empresarial. PODECIBI"},{"const":"0190","title":"ISR Sociedades cooperativas de producción"},{"const":"0191","title":"Información sobre su situación fiscal"},{"const":"0192","title":"Estados financieros"},{"const":"0201","title":"Impuesto al activo"},{"const":"0202","title":"Impuesto al activo por consolidación"},{"const":"0203","title":"Impuesto al activo. Impuesto de los integrantes de personas morales del régimen simplificado"},{"const":"0301","title":"Impuesto al valor agregado"},{"const":"0302","title":"IVA ajuste"},{"const":"0303","title":"IVA actos accidentales"},{"const":"0304","title":"IVA retenciones"},{"const":"0308","title":"IVA del régimen de incorporación fiscal"},{"const":"0309","title":"IVA Opción de acumulación de ingresos por personas morales"},{"const":"0309RF","title":"IVA Opción de acumulación de ingresos por personas morales RFN"},{"const":"0311","title":"IVA retenciones por el uso de plataformas tecnológicas"},{"const":"0312","title":"Impuesto al valor agregado región fronteriza"},{"const":"0313","title":"IVA personas físicas plataformas tecnológicas, pago definitivo"},{"const":"0314","title":"Impuesto al Valor Agregado por la prestación de servicios digitales"},{"const":"0315","title":"IVA retenciones por el uso de plataformas tecnológicas"},{"const":"0316","title":"IVA personas físicas plataformas tecnológicas"},{"const":"0318","title":"IVA simplificado de confianza"},{"const":"0401","title":"IEPS por bebidas alcohólicas"},{"const":"0402","title":"IEPS por cerveza"},{"const":"0403","title":"IEPS por bebidas refrescantes"},{"const":"0404","title":"IEPS por alcohol, alcohol desnaturalizado y mieles incristalizables"},{"const":"0405","title":"IEPS por tabacos labrados"},{"const":"0406","title":"IEPS por telecomunicaciones"},{"const":"0407","title":"IEPS por refrescos y sus concentrados"},{"const":"0408","title":"IEPS retenciones"},{"const":"0415","title":"IEPS por juegos con apuestas y/o sorteos"},{"const":"0424","title":"IEPS por bebidas energetizantes"},{"const":"0430","title":"IEPS por bebidas saborizadas"},{"const":"0431","title":"IEPS por combustibles fósiles"},{"const":"0432","title":"IEPS por plaguicidas"},{"const":"0433","title":"IEPS por alimentos no básicos con alta densidad calórica"},{"const":"0434","title":"IEPS por combustibles automotrices"},{"const":"0435","title":"IEPS por enajenación de gasolinas y diésel"},{"const":"0436","title":"IEPS por bebidas alcohólicas RIF"},{"const":"0437","title":"IEPS por cerveza RIF"},{"const":"0438","title":"IEPS por tabacos labrados RIF"},{"const":"0439","title":"IEPS por bebidas saborizadas RIF"},{"const":"0440","title":"IEPS por plaguicidas RIF"},{"const":"0441","title":"IEPS por alimentos no básicos con alta densidad calórica RIF"},{"const":"0449","title":"IEPS retenciones por apuestas y sorteos"},{"const":"0501","title":"Impuesto sustitutivo del crédito al salario"},{"const":"0601","title":"Impuesto a la venta de bienes y servicios suntuarios"},{"const":"0801","title":"ISR enajenación de terrenos y/o construcciones para la entidad federativa"},{"const":"0803","title":"ISR personas físicas. Actividad empresarial. Régimen intermedio para entidades federativas"},{"const":"0807","title":"IETU Pequeños Contribuyentes"},{"const":"0901","title":"Impuesto por la Actividad de Exploración y Extracción de Hidrocarburos"},{"const":"0909","title":"Nuevo concepto de pago"},{"const":"10910","title":"Multas por Infracciones a Obligaciones Fiscales"},{"const":"1176","title":"ISR personas morales. Chetumal"},{"const":"1179","title":"ISR personas morales. PODECOBI"},{"const":"1181","title":"ISR personas morales. PODECIBI"},{"const":"20430","title":"Impuesto sobre tenencia o uso de aeronaves"},{"const":"20806","title":"Multas por Infracciones a las Disposiciones sobre Comercio Exterior"},{"const":"2102","title":"Impuesto empresarial a tasa única"},{"const":"2103","title":"IETU impuesto de los integrantes de personas morales. Régimen simplificado"},{"const":"2106","title":"Impuesto a los depósitos en efectivo"},{"const":"2108","title":"IDE sistema financiero"},{"const":"70503","title":"Reintegro de Devoluciones Improcedentes de ISR Personas Físicas"},{"const":"70504","title":"Reintegro de Devoluciones Improcedentes, Otros (Diferentes a ISR Personas Físicas)"},{"const":"70508","title":"Impuesto sobre servicios expresamente declarados del interés publico (transmisión de radio y televisión)"},{"const":"9000","title":"Declaración Informativa de Depósitos en Efectivo"},{"const":"9002","title":"DIEMSE"},{"const":"9003","title":"Declaración Informativa Forma 81"},{"const":"9004","title":"Declaración Informativa Forma 63"},{"const":"9005","title":"Declaración Informativa Forma 76"},{"const":"9006","title":"Declaración Informativa de Operaciones con Terceros (DIOT)"},{"const":"9101","title":"IEPS Plataformas Tecnológicas"}],"description":"Options from the *Obligacion* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogTipoDeDeclaracion":{"type":"string","oneOf":[{"const":"001","title":"Normal"},{"const":"002","title":"Complementaria"},{"const":"003","title":"Normal por Corrección Fiscal"},{"const":"004","title":"Complementaria por Corrección Fiscal"},{"const":"005","title":"Complementaria por Dictamen"},{"const":"006","title":"Complementaria Esquema Anterior"},{"const":"009","title":"Complementaria por Desconsolidación"},{"const":"010","title":"Complementaria por Desincorporación"}],"description":"Options from the *Tipo de declaración* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogBancoPagoDeLineaDeCaptura":{"type":"string","oneOf":[{"const":"37019","title":"Banjercito, S. N. C."},{"const":"40002","title":"Banco Nacional de México, S.A."},{"const":"40012","title":"BBVA Bancomer, S.A."},{"const":"40014","title":"Banco Santander (México), S.A."},{"const":"40021","title":"HSBC México, S.A."},{"const":"40030","title":"Banco del Bajío, S.A."},{"const":"40032","title":"IXE Banco, S.A."},{"const":"40036","title":"Banco Inbursa, S.A."},{"const":"40037","title":"Banco Interacciones, S.A."},{"const":"40042","title":"Banca Mifel, S.A."},{"const":"40044","title":"Scotiabank Inverlat, S.A."},{"const":"40058","title":"Banco Regional de Monterrey, S.A."},{"const":"40060","title":"Bansi, S.A."},{"const":"40062","title":"Banca Afirme, S.A."},{"const":"40072","title":"Banco Mercantil del Norte, S.A."},{"const":"40102","title":"The Royal Bank of Scotland México, S.A."},{"const":"40106","title":"Bank of America México, S.A."},{"const":"40108","title":"Bank of Tokyo-Mitsubishi UFJ (México), S.A."},{"const":"40112","title":"Banco Monex, S.A."},{"const":"40113","title":"Banco Ve por Mas, S.A."},{"const":"40127","title":"Banco Azteca, S.A."},{"const":"40128","title":"Banco Autofin México, S.A."},{"const":"40132","title":"Banco Multiva, S.A."},{"const":"40133","title":"Banco Actinver, S.A."},{"const":"40136","title":"Intercam Banco, S.A."},{"const":"40143","title":"CIBanco, S.A."},{"const":"40145","title":"Banco Base, S.A."},{"const":"40152","title":"Banco Bancrea, S.A."},{"const":"99001","title":"Tesorería de la Federación"},{"const":"37166","title":"Banco del Bienestar, S.A."},{"const":"40147","title":"Bankaool, S.A."},{"const":"40124","title":"CBM Banco, S.A."},{"const":"40156","title":"Banco Sabadell, S.A."}],"description":"Options from the *Banco Pago de Línea de Captura* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogNumeroASolicitar":{"type":"string","oneOf":[{"const":"1","title":"1"},{"const":"2","title":"2"},{"const":"3","title":"3"},{"const":"4","title":"4"},{"const":"5","title":"5"},{"const":"6","title":"6"},{"const":"7","title":"7"},{"const":"8","title":"8"},{"const":"9","title":"9"},{"const":"10","title":"10"},{"const":"11","title":"11"},{"const":"12","title":"12"},{"const":"13","title":"13"},{"const":"14","title":"14"},{"const":"15","title":"15"},{"const":"16","title":"16"},{"const":"17","title":"17"},{"const":"18","title":"18"},{"const":"19","title":"19"},{"const":"20","title":"20"},{"const":"21","title":"21"},{"const":"22","title":"22"},{"const":"23","title":"23"},{"const":"24","title":"24"},{"const":"25","title":"25"},{"const":"26","title":"26"},{"const":"27","title":"27"},{"const":"28","title":"28"},{"const":"29","title":"29"},{"const":"30","title":"30"},{"const":"31","title":"31"},{"const":"32","title":"32"},{"const":"33","title":"33"},{"const":"34","title":"34"},{"const":"35","title":"35"},{"const":"36","title":"36"}],"description":"Options from the *Número a Solicitar* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogMeses":{"type":"string","oneOf":[{"const":"001","title":"Enero"},{"const":"002","title":"Febrero"},{"const":"003","title":"Marzo"},{"const":"004","title":"Abril"},{"const":"005","title":"Mayo"},{"const":"006","title":"Junio"},{"const":"007","title":"Julio"},{"const":"008","title":"Agosto"},{"const":"009","title":"Septiembre"},{"const":"010","title":"Octubre"},{"const":"011","title":"Noviembre"},{"const":"012","title":"Diciembre"}],"description":"Options from the *Meses* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalog419":{"type":"string","oneOf":[{"const":"CA01","title":"Sin actividad"},{"const":"CA02","title":"Hidricarburos o petrolíferos"},{"const":"CA03","title":"Distribución de gas licuado de petróleo"},{"const":"CA04","title":"Enajenación en estaciones de servicio de gasolinas y diésel"},{"const":"CA05","title":"Sombreros de palma y paja"},{"const":"CA06","title":"Abarrotes con venta de granos, semillas y chiles secos, azúcar, carnes en estado natural; cereales y granos en general; leches naturales, masa para tortillas de maíz, pan; billetes de lotería y teatros"},{"const":"CA07","title":"Cereales y granos en general"},{"const":"CA08","title":"Producción de leches naturales"},{"const":"CA09","title":"Abarrotes con venta de vinos y licores de producción nacional; salchichonería, café para consumo nacional; dulces, confites, bombones y chocolates; legumbres, nieves y helados, galletas y pastas alimenticias, cerveza y refrescos embotellados, hielo, jabones y detergentes, libros, papeles y artículos de escritorio, confecciones, telas y artículos de algodón, artículos para deportes; pieles y cueros, productos obtenidos del mar, lagos y ríos, substancias y productos químicos o farmacéuticos, velas y veladoras; cemento, cal y arena, explosivos; ferreterías y tlapalerías; fierro y acero, pinturas y barnices, vidrio y otros materiales para construcción, llantas y cámaras, automóviles, camiones, piezas de repuesto y otros artículos del ramo, con excepción de accesorios"},{"const":"CA10","title":"Café para consumo nacional y legumbres"},{"const":"CA11","title":"Productos obtenidos del mar, lagos, lagunas y ríos"},{"const":"CA12","title":"Masa para tortillas de maíz y pan de precio popular"},{"const":"CA13","title":"Espectáculos en arenas, cines y campos deportivos"},{"const":"CA14","title":"Azúcar, leches naturales; aceites vegetales; café para consumo nacional; maquila en molienda de nixtamal, molienda de trigo y arroz; galletas y pastas alimenticias; jabones y detergentes; confecciones, telas y artículos de algodón; artículos para deportes; pieles y cueros; calzado de todas clases; explosivos, armas y municiones; fierro y acero; construcción de inmuebles; pintura y barnices, vidrio y otros materiales para construcción; muebles de madera corriente; extracción de gomas y resinas; velas y veladoras; imprenta; litografía y encuadernación."},{"const":"CA15","title":"Explotación y refinación de sal, extracción de maderas finas, metales y plantas minero-metalúrgicas"},{"const":"CA16","title":"Restaurantes y agencias funerarias"},{"const":"CA17","title":"Dulces, bombones, confites y chocolates, cerveza, alcohol, perfumes, esencias, cosméticos y otros productos de tocador; instrumentos musicales, discos y artículos del ramo; joyería y relojería; papel y artículos de papel; artefactos de polietileno, de hule natural o sintético; llantas y cámaras; automóviles, camiones, piezas de repuesto y otros artículos del ramo"},{"const":"CA18","title":"Fraccionamiento y fábricas de cemento"},{"const":"CA19","title":"Comisionistas y otorgamiento del uso o goce temporal de inmuebles"},{"const":"CA20","title":"Prestación de servicios personales independientes"}],"description":"Options from SAT's catalog 419. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalog10EjerciciosInmediatosAnteriores":{"type":"string","oneOf":[{"const":"2026","title":"2026"},{"const":"2025","title":"2025"},{"const":"2024","title":"2024"},{"const":"2023","title":"2023"},{"const":"2022","title":"2022"},{"const":"2021","title":"2021"},{"const":"2020","title":"2020"},{"const":"2019","title":"2019"},{"const":"2018","title":"2018"},{"const":"2017","title":"2017"},{"const":"2016","title":"2016"}],"description":"Options from the *10 Ejercicios inmediatos anteriores* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogPeriodos":{"type":"string","oneOf":[{"const":"001","title":"Enero"},{"const":"002","title":"Febrero"},{"const":"003","title":"Marzo"},{"const":"004","title":"Abril"},{"const":"005","title":"Mayo"},{"const":"006","title":"Junio"},{"const":"007","title":"Julio"},{"const":"008","title":"Agosto"},{"const":"009","title":"Septiembre"},{"const":"010","title":"Octubre"},{"const":"011","title":"Noviembre"},{"const":"012","title":"Diciembre"},{"const":"020","title":"1° Enero-Junio"},{"const":"021","title":"2° Julio-Diciembre"}],"description":"Options from the *Periodos* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogIVAPFPeriodo":{"type":"string","oneOf":[{"const":"001","title":"Enero"},{"const":"002","title":"Febrero"},{"const":"003","title":"Marzo"},{"const":"004","title":"Abril"},{"const":"005","title":"Mayo"},{"const":"006","title":"Junio"},{"const":"007","title":"Julio"},{"const":"008","title":"Agosto"},{"const":"009","title":"Septiembre"},{"const":"010","title":"Octubre"},{"const":"011","title":"Noviembre"},{"const":"012","title":"Diciembre"},{"const":"013","title":"1° Enero-Marzo"},{"const":"014","title":"2° Abril-Junio"},{"const":"015","title":"3° Julio-Septiembre"},{"const":"016","title":"4° Octubre-Diciembre"},{"const":"020","title":"1° Enero-Junio"},{"const":"021","title":"2° Julio-Diciembre"}],"description":"Options from the *IVA PF Periodo* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true},"SatCatalogEstatusDeDeclaracionesProvicionales":{"type":"string","oneOf":[{"const":"","title":""},{"const":"ED01","title":"Presentada-Pagada"},{"const":"ED02","title":"Presentada-No pagada"},{"const":"ED03","title":"No presentada"},{"const":"ED04","title":"Presentada-Pago en cero"},{"const":"ED05","title":"Presentada sin pago monto pagado con anterioridad"},{"const":"ED06","title":"Presentada pagada con pago diferido o en parcialidades"}],"description":"Options from the *Estatus de declaraciones provicionales* catalog. Send the value. The title is its label on the form.","x-scalar-ignore":true}}}}