gigstack API
  1. Schemas
gigstack API
  • Welcome to gigstack API
  • gigstack Connect API Guide
  • Migrar de API v1 a v2 de gigstack
  • Clients
    • Clients API Guide
    • List clients
    • Get client
    • Update client
    • Create client
    • Validate client fiscal information
    • Get client customer portal access token
    • Stamp pending receipts
    • Delete client
    • Upload CSF PDF to create or update client
  • Services
    • Services API Guide
    • List services
    • Get service
    • Update service
    • Create service
    • Delete service
  • Invoices
    • Invoices API Guide
    • Income
      • List income invoices
      • Get income invoice
      • Create income invoice
    • Egress
      • List egress invoices
      • Get egress invoice
      • Create egress invoice
    • List payment complement invoices
    • Get payment complement invoice
    • Get invoice files
    • Cancel invoice
  • Payments
    • Payments API Guide
    • List payments
    • Get payment
    • Request payment
    • Register payment
    • Mark payment as paid
    • Refund payment
    • Cancel payment
  • Receipts
    • Receipts API Guide
    • List receipts
    • Get receipt
    • Create receipt
    • Stamp receipt
    • Cancel receipt
  • Teams
    • Teams API Guide
    • List teams
    • Get team
    • Get team integrations
    • Get team series
    • Get team onboarding URL
    • Update team
    • Update team series
    • Update team settings
    • Create team
    • Add team member
    • Remove team member
    • Create team series
    • Upload SAT CSD certificates
  • Users
    • Users API Guide
    • List users
    • Get user
    • Update user
    • Create user
    • Reset user password
    • Generate login link
  • Catalogs
    • Tax Regimes Catalog (Régimen Fiscal)
    • Payment Forms | Formas de pago
    • CFDI Usage Catalog (Uso CFDI)
    • Payment Methods Catalog (Método de Pago)
    • Months and Bimesters Catalog (Meses y Bimestres)
    • Invoice Relationships Catalog (Relación entre Facturas)
  • Webhooks
    • Webhooks
    • List webhooks
    • Create webhook
    • Get webhook
    • Update webhook
    • Delete webhook
  • Schemas
    • Schemas
      • ApiResponse
      • Client
      • OrderDirection
      • ApiPublicClient
      • Service
      • Category
      • DateRangeFilter
      • ApiPublicService
      • Pet
      • ListQueryParams
      • ClientInput
      • PaginationMeta
      • Tag
      • ServiceInput
      • Invoice
      • Order
      • InvoiceIncomeInput
      • Payment
      • PaymentInput
      • InvoiceInput
      • Team
      • InvoiceEgressInput
      • PaymentItem
      • TeamInput
      • PaymentAllowedMethod
      • TeamSettingsInput
      • ApiPublicPaymentProcessorDetails
      • User
      • ApiPublicPayment
      • UserInput
      • ClientAddress
      • TaxSchema
      • StandardSuccessResponse
      • RequestPaymentInput
      • RegisterPaymentInput
      • ListResponse
      • ErrorResponse
      • ApiPublicIncomeInvoice
      • ValidationErrorResponse
      • RefundPaymentInput
      • ApiPublicTeam
      • UnauthorizedError
      • MarkPaymentAsPaidInput
      • ApiPublicUser
      • ApiPublicSearch
      • NotFoundError
      • ApiPublicThirdParty
      • InternalServerError
      • ApiPublicInvoiceConfig
      • ApiPublicRefund
      • TeamSettings
      • ApiPublicAutomations
      • TaxElement
      • SeriesInput
      • Series
      • ApiPublicWebhook
      • ReceiptInput
      • WebhookInput
      • WebhookUpdateInput
      • PaymentMethodEnum
      • PaymentFormEnum
      • AutomationTypeEnum
      • StandardizedSuccessResponse
      • ItemSchema
      • StandardizedErrorResponse
      • ApiErrorCode
    • RequestBodies
      • UserArray
  1. Schemas

InvoiceInput

{
    "client": {
        "id": "client_1234567890",
        "search": {
            "on_key": "tax_id",
            "on_value": "PEGJ800101ABC",
            "auto_create": true,
            "safety_check": false
        },
        "address": {
            "country": "Mexico",
            "street": "Av. Insurgentes Sur",
            "zip": "03100",
            "city": "Ciudad de México",
            "state": "CDMX",
            "exterior": "123",
            "interior": "4B",
            "municipality": "Benito Juárez",
            "neighborhood": "Del Valle"
        },
        "name": "Juan Pérez García",
        "company": "Empresa SA de CV",
        "phone": "+52 55 1234 5678",
        "email": "juan.perez@ejemplo.com",
        "bcc": [
            "user@example.com"
        ],
        "legal_name": "Juan Pérez García",
        "tax_id": "PEGJ800101ABC",
        "use": "P01",
        "tax_system": "601",
        "metadata": {}
    },
    "automation": "pue_invoice",
    "currency": "MXN",
    "exchange_rate": 1,
    "items": [
        {
            "id": "service_1234567890",
            "search": {
                "on_key": "sku",
                "on_value": "CONS-001",
                "auto_create": true,
                "safety_check": false
            },
            "quantity": 1,
            "description": "Consulting services",
            "sku": "CONS-001",
            "product_key": "80141503",
            "unit_key": "E48",
            "unit_name": "Servicio",
            "unit_price": 1000,
            "discount": 0,
            "taxes": [
                {
                    "base": "01",
                    "factor": "Tasa",
                    "inclusive": false,
                    "rate": 0.16,
                    "type": "IVA",
                    "withholding": false
                }
            ],
            "third_party": {
                "legal_name": "Third Party SA",
                "tax_id": "TPR800101ABC",
                "tax_system": "601",
                "zip": "03100"
            },
            "metadata": {}
        }
    ],
    "invoice_type": "I",
    "use": "P01",
    "payment_form": "01",
    "payment_method": "PUE",
    "payment_conditions": "",
    "export_classification": "01",
    "global": {
        "periodicity": "04",
        "months": "01",
        "year": 2024
    },
    "series": "A",
    "folio": "123",
    "addenda": "",
    "invoice_pdf_notes": "",
    "related_documents": [
        {
            "relationship": "04",
            "documents": [
                "12345678-1234-1234-1234-123456789012"
            ]
        }
    ],
    "complements": [
        {
            "type": "custom",
            "data": "<xml>...</xml>"
        }
    ],
    "send_email": true,
    "emails": [
        "client@example.com"
    ],
    "metadata": {},
    "idempotency_key": "invoice-key-12345"
}
Built with