Send document
Emails a supported production document or its available files to the selected recipient. Sandbox artifacts can be downloaded but not emailed.
- Endpoint
POST /v1/documents/{documentRef}/send- Authorization
- The document category encoded in the reference determines the required permission: `invoice` → `invoices:manage`, `withholding` → `invoices:manage`, `sales_receipt` → `receipts:update`.
- Environments
- Production only
- Idempotency
- Required for safe retries.
- Common next step
Download document file GET
Downloads an available document file. For an unstamped CFDI draft, use preview_pdf to inspect the rendered PDF before stamping; the preview has no fiscal validity. When available, cancellation_xml and cancellation_pdf return the cancellation acknowledgement. Its availability alone does not establish completed cancellation; inspect the document status separately.
Get payroll settings GET
Returns the payroll settings: the minimum wage zone the employer confirmed (absent until then; without it only employees with their own minimumWageZone are calculated) with the zone the organization's postal code suggests by its municipality (absent when the SAT's postal-code catalog does not settle it), the default RiesgoPuesto and ClaveEntFed for employees without their own, and the pay calendar (weekly start day and catorcenal anchor).