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

ApiPublicIncomeInvoice

{
    "uuid": "invoice_1234567890",
    "client": {
        "id": "client_1234567890",
        "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": [
            "admin@empresa.com"
        ],
        "metadata": {
            "custom_field": "value"
        },
        "is_valid": true,
        "from": "api",
        "legal_name": "Juan Pérez García",
        "livemode": true,
        "owner": "user_1234567890",
        "tax_id": "PEGJ800101ABC",
        "use": "P01",
        "tax_system": "601",
        "team": "team_1234567890",
        "created_at": 1677651234,
        "efos": {
            "is_valid": true
        },
        "defaults": {
            "keep_full_legal_name": false,
            "issue_automatic_invoices": false,
            "issue_invoiceable_receipts": true
        }
    },
    "created_at": 1677651234,
    "currency": "MXN",
    "exchange_rate": 1,
    "total": 1160,
    "subtotal": 1000,
    "taxes": 160,
    "discount": 0,
    "withholding_taxes": 0,
    "series": "A",
    "folio_number": 123,
    "invoice_type": "I",
    "use": "P01",
    "payment_form": "03",
    "payment_method": "PUE",
    "status": "draft",
    "livemode": true,
    "owner": "user_1234567890",
    "from": "api",
    "items": [
        {
            "id": "item_1234567890",
            "description": "Professional consulting services",
            "product_key": "80141503",
            "quantity": 1,
            "unit_price": 1000,
            "unit_key": "E48",
            "unit_name": "Servicio",
            "sku": "CONS-001",
            "taxability": "01",
            "taxes": [
                {
                    "base": "01",
                    "factor": "Tasa",
                    "inclusive": false,
                    "rate": 0.16,
                    "type": "IVA",
                    "withholding": false
                }
            ]
        }
    ],
    "payments": [
        "payment_1234567890"
    ],
    "invoices": [],
    "stamp": {
        "sello": "ABC123...",
        "stamp_at": 1677651234
    },
    "cancellation": {
        "cancellation_status": "cancelled",
        "cancelled_at": 1677651234,
        "motive": "02",
        "code": "201"
    },
    "verification_url": "https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx",
    "exports": "01",
    "addenda": "",
    "invoice_pdf_notes": "Additional notes for PDF",
    "files": {
        "pdf": "JVBERi0xLjQKJeLjz9MKMSAwIG9ia...",
        "xml": "PD94bWwgdmVyc2lvbj0iMS4wIiBlbmNvZGluZz0idXRmLTgiPz4..."
    }
}
Built with