# gigstack API documentation Documentation revision: c93e669a448079a0f93d0bd422ebf86b264a8b19e8f0b5da22b4a281c4028989 > Shared API fields and country-specific invoicing. Select the issuing team and country before using fiscal examples. A guide is not authorization to execute an operation. ## Machine-readable resources - [OpenAPI contract](https://docs.gigstack.io/openapi.json) - [Structured workflows](https://docs.gigstack.io/examples/workflows.json) - [Documentation search MCP](https://docs.gigstack.io/mcp) ## All pages - [Build your first invoicing flow](https://docs.gigstack.io/index.md) - [Your first successful request](https://docs.gigstack.io/quickstart.md) - [Authentication and test mode](https://docs.gigstack.io/authentication.md) - [Set up the issuing business](https://docs.gigstack.io/concepts/issuer-setup.md) - [Shared fields and country rules](https://docs.gigstack.io/concepts/shared-fields.md) - [Mexico: fields and invoice flow](https://docs.gigstack.io/countries/mexico.md) - [Colombia: fields and invoice flow](https://docs.gigstack.io/countries/colombia.md) - [Create a customer once](https://docs.gigstack.io/recipes/customer.md) - [Record a payment already received](https://docs.gigstack.io/recipes/payment.md) - [Record a refund or request one through Stripe](https://docs.gigstack.io/recipes/refund.md) - [Understand a sale in five minutes](https://docs.gigstack.io/concepts/invoicing.md) - [Draft, preview, and issue an invoice](https://docs.gigstack.io/recipes/invoice.md) - [Invoice now, receive a partial payment later](https://docs.gigstack.io/recipes/paid-later.md) - [Let a customer invoice later](https://docs.gigstack.io/recipes/receipt.md) - [Issue a credit note for a discount](https://docs.gigstack.io/recipes/credit-note.md) - [Cancel a CFDI and verify the result](https://docs.gigstack.io/recipes/cancellation.md) - [Responses, pagination, and retries](https://docs.gigstack.io/responses.md) - [Find the next useful step](https://docs.gigstack.io/troubleshooting.md) - [Build with agents](https://docs.gigstack.io/agents.md) - [What we verified](https://docs.gigstack.io/verification.md) - [Invoices API Guide](https://docs.gigstack.io/guides/invoices.md) - [Invoice Batches API Guide](https://docs.gigstack.io/guides/invoice-batches.md) - [Receipts API Guide](https://docs.gigstack.io/guides/receipts.md) - [Retentions API Guide](https://docs.gigstack.io/guides/retentions.md) - [Platform Payouts API Guide](https://docs.gigstack.io/guides/platform-payouts.md) - [Clients API Guide](https://docs.gigstack.io/guides/clients.md) - [Services API Guide](https://docs.gigstack.io/guides/services.md) - [Payments API Guide](https://docs.gigstack.io/guides/payments.md) - [Documents API Guide](https://docs.gigstack.io/guides/documents.md) - [Webhooks API Guide](https://docs.gigstack.io/guides/webhooks.md) - [Descarga Masiva SAT Guide](https://docs.gigstack.io/guides/descarga-masiva.md) - [SAT Lists API Guide](https://docs.gigstack.io/guides/sat-lists.md) - [gigstack Connect API Guide](https://docs.gigstack.io/guides/gigstack-connect.md) - [Teams API Guide](https://docs.gigstack.io/guides/teams.md) - [Users API Guide](https://docs.gigstack.io/guides/users.md) - [API fundamentals](https://docs.gigstack.io/guides/welcome.md) - [Migrate from API v1 to v2](https://docs.gigstack.io/guides/migration-v1-to-v2.md) - [Payment Forms Catalog (Formas de Pago)](https://docs.gigstack.io/guides/catalogs/payment_forms.md) - [Payment Methods Catalog (Métodos de Pago)](https://docs.gigstack.io/guides/catalogs/payment_methods.md) - [CFDI Usage Catalog (Uso CFDI)](https://docs.gigstack.io/guides/catalogs/usages.md) - [Tax Regimes Catalog (Régimen Fiscal)](https://docs.gigstack.io/guides/catalogs/tax_regimes.md) - [Cancellation Motives Catalog (Motivos de Cancelación)](https://docs.gigstack.io/guides/catalogs/cancellation_motives.md) - [Invoice Relationships Catalog (Relación entre Facturas)](https://docs.gigstack.io/guides/catalogs/invoice_relationships.md) - [Global Invoices (Factura Global)](https://docs.gigstack.io/guides/catalogs/invoices_globals.md) - [Months and Bimesters Catalog (Meses y Bimestres)](https://docs.gigstack.io/guides/catalogs/months_and_bimesters.md) - [CFDI Errors Reference](https://docs.gigstack.io/guides/catalogs/cfdi_errors.md) - [List clients](https://docs.gigstack.io/reference/listClients.md) - [Create client](https://docs.gigstack.io/reference/createClients.md) - [Get client](https://docs.gigstack.io/reference/getClientsById.md) - [Update client](https://docs.gigstack.io/reference/updateClientsById.md) - [Delete client](https://docs.gigstack.io/reference/deleteClientsById.md) - [Search clients](https://docs.gigstack.io/reference/getClientsSearch.md) - [Validate client fiscal information](https://docs.gigstack.io/reference/createClientsValidateById.md) - [Get client customer portal access token](https://docs.gigstack.io/reference/createClientsCustomerportal.md) - [Upload CSF PDF to create or update client](https://docs.gigstack.io/reference/createClientsCsf.md) - [Stamp pending receipts](https://docs.gigstack.io/reference/stampClientPendingReceipts.md) - [Upload support document](https://docs.gigstack.io/reference/createClientsByIdSupportDocuments.md) - [List support documents](https://docs.gigstack.io/reference/getClientsByIdSupportDocuments.md) - [Health check](https://docs.gigstack.io/reference/clientsHealth.md) - [List services](https://docs.gigstack.io/reference/listServices.md) - [Create service](https://docs.gigstack.io/reference/createServices.md) - [Get service](https://docs.gigstack.io/reference/getServicesById.md) - [Update service](https://docs.gigstack.io/reference/updateServicesById.md) - [Delete service](https://docs.gigstack.io/reference/deleteServicesById.md) - [Health check](https://docs.gigstack.io/reference/servicesHealth.md) - [List SAT invoices](https://docs.gigstack.io/reference/listSatInvoices.md) - [Get a SAT invoice](https://docs.gigstack.io/reference/getSatInvoice.md) - [Import CFDI XMLs the team already holds](https://docs.gigstack.io/reference/importInvoiceXml.md) - [Retry XML download](https://docs.gigstack.io/reference/retrySatXmlDownload.md) - [Generate PDF for a received SAT invoice](https://docs.gigstack.io/reference/generateSatPdf.md) - [Check activation status](https://docs.gigstack.io/reference/getInvoicesDownloadActivateStatus.md) - [Activate Descarga Masiva SAT](https://docs.gigstack.io/reference/createInvoicesDownloadActivate.md) - [Deactivate Descarga Masiva SAT](https://docs.gigstack.io/reference/createInvoicesDownloadDeactivate.md) - [Upload FIEL credentials](https://docs.gigstack.io/reference/createInvoicesDownloadFiel.md) - [Register business with SAT (manual)](https://docs.gigstack.io/reference/createInvoicesDownloadRegister.md) - [Get schedule configuration](https://docs.gigstack.io/reference/getInvoicesDownloadSchedule.md) - [Save schedule configuration](https://docs.gigstack.io/reference/updateInvoicesDownloadSchedule.md) - [Get download request history](https://docs.gigstack.io/reference/getInvoicesDownloadScheduleHistory.md) - [Get SAT history sync progress](https://docs.gigstack.io/reference/getInvoicesDownloadProgress.md) - [Preview a range of SAT history before paying for it](https://docs.gigstack.io/reference/createInvoicesDownloadPreview.md) - [List recent preview and import jobs](https://docs.gigstack.io/reference/listInvoicesDownloadJobs.md) - [Get one job with per-window detail](https://docs.gigstack.io/reference/getInvoicesDownloadJob.md) - [Stop a running job](https://docs.gigstack.io/reference/cancelInvoicesDownloadJob.md) - [Download XMLs for chosen CFDIs](https://docs.gigstack.io/reference/importInvoicesDownload.md) - [Create bulk download request](https://docs.gigstack.io/reference/createInvoicesDownloadRequest.md) - [Check download request status](https://docs.gigstack.io/reference/getInvoicesDownloadStatusByRequestId.md) - [Download XML package](https://docs.gigstack.io/reference/getInvoicesDownloadPackageByPackageId.md) - [Get single invoice from SAT](https://docs.gigstack.io/reference/getInvoicesDownloadInvoiceByUuid.md) - [Debug registration status](https://docs.gigstack.io/reference/getInvoicesDownloadDebug.md) - [Enable SAT sync](https://docs.gigstack.io/reference/createInvoicesDownloadEnableSync.md) - [Connect FIEL credentials from a PFX file](https://docs.gigstack.io/reference/connectFielPfx.md) - [Update bulk-download sync period](https://docs.gigstack.io/reference/updateBulkDownloadSyncPeriod.md) - [List CFDI errors](https://docs.gigstack.io/reference/getInvoicesErrors.md) - [List income invoices](https://docs.gigstack.io/reference/getInvoicesIncome.md) - [Create income invoice](https://docs.gigstack.io/reference/createInvoicesIncome.md) - [Create a batch of income invoices](https://docs.gigstack.io/reference/createIncomeInvoiceBatch.md) - [Get an income invoice batch](https://docs.gigstack.io/reference/getIncomeInvoiceBatch.md) - [List the items of an income invoice batch](https://docs.gigstack.io/reference/listIncomeInvoiceBatchItems.md) - [Get income invoice](https://docs.gigstack.io/reference/getInvoicesIncomeById.md) - [List egress invoices](https://docs.gigstack.io/reference/getInvoicesEgress.md) - [Create egress invoice](https://docs.gigstack.io/reference/createInvoicesEgress.md) - [Get egress invoice](https://docs.gigstack.io/reference/getInvoicesEgressById.md) - [List transfer invoices](https://docs.gigstack.io/reference/getInvoicesTransfer.md) - [Create transfer invoice (Carta Porte)](https://docs.gigstack.io/reference/postInvoicesTransfer.md) - [Get transfer invoice](https://docs.gigstack.io/reference/getInvoicesTransferById.md) - [List payment complement invoices](https://docs.gigstack.io/reference/getInvoicesPayment.md) - [Create payment complement (complemento de pago)](https://docs.gigstack.io/reference/createInvoicesPayment.md) - [Get payment complement invoice](https://docs.gigstack.io/reference/getInvoicesPaymentById.md) - [Get invoice files](https://docs.gigstack.io/reference/getInvoicesByIdFiles.md) - [Resend invoice email](https://docs.gigstack.io/reference/createInvoicesByIdSend.md) - [Upload support document](https://docs.gigstack.io/reference/createInvoicesByIdSupportDocuments.md) - [List support documents](https://docs.gigstack.io/reference/getInvoicesByIdSupportDocuments.md) - [Get invoice](https://docs.gigstack.io/reference/getInvoiceById.md) - [Cancel invoice](https://docs.gigstack.io/reference/cancelInvoice.md) - [Search invoices](https://docs.gigstack.io/reference/getInvoicesSearch.md) - [List draft invoices](https://docs.gigstack.io/reference/getInvoicesDraft.md) - [Create draft invoice (pre-factura)](https://docs.gigstack.io/reference/createInvoicesDraft.md) - [Get draft invoice](https://docs.gigstack.io/reference/getInvoicesDraftById.md) - [Update draft invoice](https://docs.gigstack.io/reference/updateInvoicesDraftById.md) - [Delete draft invoice](https://docs.gigstack.io/reference/deleteInvoicesDraftById.md) - [Stamp draft invoice (finalize)](https://docs.gigstack.io/reference/createInvoicesDraftByIdStamp.md) - [Generate draft preview PDF (pre-factura)](https://docs.gigstack.io/reference/createInvoicesDraftByIdPreview.md) - [Health check](https://docs.gigstack.io/reference/invoicesHealth.md) - [Trigger end-of-month global invoicing](https://docs.gigstack.io/reference/runEndOfMonthInvoicing.md) - [List payments](https://docs.gigstack.io/reference/listPayments.md) - [Search payments](https://docs.gigstack.io/reference/getPaymentsSearch.md) - [Get payment](https://docs.gigstack.io/reference/getPaymentsById.md) - [Update payment](https://docs.gigstack.io/reference/updatePaymentsById.md) - [Cancel payment](https://docs.gigstack.io/reference/deletePaymentsById.md) - [Request payment](https://docs.gigstack.io/reference/createPaymentsRequest.md) - [Register payment](https://docs.gigstack.io/reference/createPaymentsRegister.md) - [Mark payment as paid](https://docs.gigstack.io/reference/createPaymentsByIdPaid.md) - [Refund payment](https://docs.gigstack.io/reference/createPaymentsByIdRefund.md) - [Upload support document](https://docs.gigstack.io/reference/createPaymentsByIdSupportDocuments.md) - [List support documents](https://docs.gigstack.io/reference/getPaymentsByIdSupportDocuments.md) - [Health check](https://docs.gigstack.io/reference/paymentsHealth.md) - [List receipts](https://docs.gigstack.io/reference/listReceipts.md) - [Create receipt](https://docs.gigstack.io/reference/createReceipts.md) - [Search receipts](https://docs.gigstack.io/reference/getReceiptsSearch.md) - [Get receipt](https://docs.gigstack.io/reference/getReceiptsById.md) - [Cancel receipt](https://docs.gigstack.io/reference/deleteReceiptsById.md) - [Stamp receipt](https://docs.gigstack.io/reference/createReceiptsByIdStamp.md) - [Reopen receipt](https://docs.gigstack.io/reference/createReceiptsByIdReopen.md) - [Health check](https://docs.gigstack.io/reference/receiptsHealth.md) - [List retentions](https://docs.gigstack.io/reference/listRetentions.md) - [Create retention](https://docs.gigstack.io/reference/createRetentions.md) - [Get retention](https://docs.gigstack.io/reference/getRetentionsById.md) - [Cancel retention](https://docs.gigstack.io/reference/deleteRetentionsById.md) - [Get retention files](https://docs.gigstack.io/reference/getRetentionsByIdFiles.md) - [List teams](https://docs.gigstack.io/reference/listTeams.md) - [Create team](https://docs.gigstack.io/reference/createTeams.md) - [Get team](https://docs.gigstack.io/reference/getTeamsById.md) - [Update team](https://docs.gigstack.io/reference/updateTeamsById.md) - [Delete team](https://docs.gigstack.io/reference/deleteTeamsById.md) - [Get team integrations (not implemented)](https://docs.gigstack.io/reference/getTeamIntegrations.md) - [Add team member](https://docs.gigstack.io/reference/createTeamsByIdAddMember.md) - [Remove team member](https://docs.gigstack.io/reference/createTeamsByIdRemoveMember.md) - [Get team series](https://docs.gigstack.io/reference/getTeamsByIdSeries.md) - [Create team series](https://docs.gigstack.io/reference/createTeamsByIdSeries.md) - [Update team series](https://docs.gigstack.io/reference/updateTeamsByIdSeriesBySeriesId.md) - [Update team settings](https://docs.gigstack.io/reference/updateTeamsByIdSettings.md) - [Get team onboarding URL](https://docs.gigstack.io/reference/getTeamsByIdOnboardingUrl.md) - [Create a portal access token](https://docs.gigstack.io/reference/createTeamsByIdPortalAccessToken.md) - [Upload SAT CSD certificates](https://docs.gigstack.io/reference/createTeamsByIdSatConnection.md) - [Sign manifest document](https://docs.gigstack.io/reference/createTeamsByIdManifestSign.md) - [Health check](https://docs.gigstack.io/reference/teamsHealth.md) - [List users](https://docs.gigstack.io/reference/listUsers.md) - [Create user](https://docs.gigstack.io/reference/createUsers.md) - [Get user](https://docs.gigstack.io/reference/getUsersById.md) - [Update user](https://docs.gigstack.io/reference/updateUsersById.md) - [Delete user](https://docs.gigstack.io/reference/deleteUser.md) - [Reset user password](https://docs.gigstack.io/reference/resetUserPassword.md) - [Generate login link](https://docs.gigstack.io/reference/createUsersLoginLink.md) - [Health check](https://docs.gigstack.io/reference/usersHealth.md) - [List webhooks](https://docs.gigstack.io/reference/listWebhooks.md) - [Create webhook](https://docs.gigstack.io/reference/createWebhooks.md) - [Get webhook](https://docs.gigstack.io/reference/getWebhooksById.md) - [Update webhook](https://docs.gigstack.io/reference/updateWebhooksById.md) - [Delete webhook](https://docs.gigstack.io/reference/deleteWebhooksById.md) - [Health check](https://docs.gigstack.io/reference/webhooksHealth.md) - [Search SAT product keys](https://docs.gigstack.io/reference/getCatalogsProductKeys.md) - [Search SAT unit keys](https://docs.gigstack.io/reference/getCatalogsUnitKeys.md) - [Health check](https://docs.gigstack.io/reference/catalogsHealth.md) - [Headless signup (API-only path)](https://docs.gigstack.io/reference/signup.md) - [Health check](https://docs.gigstack.io/reference/authHealth.md) - [List SAT lists and sync status](https://docs.gigstack.io/reference/listSatLists.md) - [Check an RFC against the SAT lists](https://docs.gigstack.io/reference/getSatListsCheckByRfc.md) - [Consult the SAT "Opinión del Cumplimiento" (32-D) for an RFC](https://docs.gigstack.io/reference/getSatOpinion32dByRfc.md) - [List documents](https://docs.gigstack.io/reference/listDocuments.md) - [Create document](https://docs.gigstack.io/reference/createDocument.md) - [Get document](https://docs.gigstack.io/reference/getDocument.md) - [Update document](https://docs.gigstack.io/reference/updateDocument.md) - [Delete document](https://docs.gigstack.io/reference/deleteDocument.md) - [Analyze document with AI](https://docs.gigstack.io/reference/analyzeDocument.md) - [Link document to an entity](https://docs.gigstack.io/reference/linkDocument.md) - [Unlink document from an entity](https://docs.gigstack.io/reference/unlinkDocument.md) - [Upload files and plan a platform payouts run](https://docs.gigstack.io/reference/createPlatformPayoutRun.md) - [Get a platform payouts run](https://docs.gigstack.io/reference/getPlatformPayoutRun.md) - [List a platform payouts run's movements](https://docs.gigstack.io/reference/listPlatformPayoutMovements.md) - [Confirm a platform payouts run for stamping](https://docs.gigstack.io/reference/confirmPlatformPayoutRun.md) - [Health check](https://docs.gigstack.io/reference/platformPayoutsHealth.md) - [gigstack API v2 Documentation](https://docs.gigstack.io/guides/index.md)