gigstack API
  1. Catalogs
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
    • Get client
      GET
    • Update client
      PUT
    • Create client
      POST
    • Validate client fiscal information
      POST
    • Get client customer portal access token
      POST
    • Stamp pending receipts
      POST
    • Delete client
      DELETE
  • Services
    • Services API Guide
    • List services
      GET
    • Get service
      GET
    • Update service
      PUT
    • Create service
      POST
    • Delete service
      DELETE
  • Invoices
    • Invoices API Guide
    • Income
      • List income invoices
      • Get income invoice
      • Create income invoice
    • Egress
      • List egress invoices
      • Get egress invoice
      • Create egress invoice
    • Get invoice files
      GET
    • Cancel invoice
      DELETE
  • 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
  • Users
    • Users API Guide
    • List users
    • Get user
    • Update user
    • Create user
    • Reset user password
  • 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)
  1. Catalogs

Months and Bimesters Catalog (Meses y Bimestres)

Overview#

The Months and Bimesters catalog defines standardized periodicity codes used in Global Invoices (Factura Global) to specify the reporting period covered by the invoice. These codes are essential for businesses that consolidate multiple transactions into periodic global invoices for tax efficiency and administrative simplification.

What We See#

This catalog contains 18 periodicity codes covering:
Individual months (01-12): Each calendar month from January to December
Bimesters (13-18): Two-month periods covering the entire year in six segments
Global invoices allow businesses to group daily transactions and issue periodic summary invoices, with the periodicity code indicating the time span covered.

How to Use It#

When creating global invoices, select the periodicity code that corresponds to the actual period being covered by the invoice. This ensures proper tax reporting and compliance with SAT regulations for consolidated invoicing.

Usage Guidelines#

Match actual period: Select the code that exactly matches the invoice period
Consistent application: Use the same periodicity consistently for your business
Tax period alignment: Ensure periodicity aligns with your tax filing schedule
Complete periods only: Global invoices should cover complete months or bimesters

Periodicity Codes Table#

Individual Months (01-12)#

CodeDescription (English)Descripción (Español)Calendar PeriodQuarter
01JanuaryEneroJan 1 - Jan 31Q1
02FebruaryFebreroFeb 1 - Feb 28/29Q1
03MarchMarzoMar 1 - Mar 31Q1
04AprilAbrilApr 1 - Apr 30Q2
05MayMayoMay 1 - May 31Q2
06JuneJunioJun 1 - Jun 30Q2
07JulyJulioJul 1 - Jul 31Q3
08AugustAgostoAug 1 - Aug 31Q3
09SeptemberSeptiembreSep 1 - Sep 30Q3
10OctoberOctubreOct 1 - Oct 31Q4
11NovemberNoviembreNov 1 - Nov 30Q4
12DecemberDiciembreDec 1 - Dec 31Q4

Bimesters (13-18)#

CodeDescription (English)Descripción (Español)Calendar PeriodMonths Covered
13January-FebruaryEnero-FebreroJan 1 - Feb 28/2901, 02
14March-AprilMarzo-AbrilMar 1 - Apr 3003, 04
15May-JuneMayo-JunioMay 1 - Jun 3005, 06
16July-AugustJulio-AgostoJul 1 - Aug 3107, 08
17September-OctoberSeptiembre-OctubreSep 1 - Oct 3109, 10
18November-DecemberNoviembre-DiciembreNov 1 - Dec 3111, 12

Global Invoice Context#

What is a Global Invoice?#

A Global Invoice (Factura Global) is a CFDI document that consolidates multiple individual transactions from a specific period into a single invoice. This is commonly used by:
Retail businesses with many daily transactions
Service providers with recurring billing
Businesses with high transaction volumes

When to Use Periodicity Codes#

Daily consolidation: Businesses that want to issue monthly summaries instead of individual receipts
Subscription services: Companies billing customers on monthly or bi-monthly cycles
Retail operations: Stores consolidating daily sales into periodic invoices
Service providers: Professional services billing on periodic schedules

Implementation Examples#

API Request Example#

{
  "global_invoice": {
    "periodicity": "01",
    "period_year": 2024,
    "start_date": "2024-01-01",
    "end_date": "2024-01-31",
    "total_transactions": 1250,
    "total_amount": 87500.00
  }
}

Validation Logic#

Period Calculation Helper#

Common Use Cases#

Retail Business - Monthly Consolidation#

Subscription Service - Bimester Billing#

Professional Services - Quarterly Summary#

Business Considerations#

Choosing Between Monthly and Bimester Periods#

Monthly Periods (01-12)#

Advantages:
More granular reporting
Easier alignment with accounting cycles
Better cash flow tracking
Standard business reporting periods
Best for:
Businesses with seasonal variations
Companies requiring detailed monthly analysis
Organizations with monthly tax obligations

Bimester Periods (13-18)#

Advantages:
Reduced administrative burden
Lower invoice processing costs
Simplified compliance for smaller businesses
Better for stable, recurring revenue
Best for:
Subscription-based businesses
Service providers with stable billing
Small businesses seeking simplification
Companies with consistent bi-monthly cycles

Important Notes#

1.
Period Completeness: Global invoices must cover complete periods - partial months or bimesters are not allowed
2.
Tax Implications: The chosen periodicity affects tax reporting schedules and obligations
3.
Customer Communication: Clearly communicate billing periods to customers using global invoices
4.
Consistency: Maintain consistent periodicity choices for regulatory compliance
5.
Leap Year Handling: February periods must account for leap years (29 days vs 28 days)

Error Prevention#

Common Mistakes#

Using partial periods (e.g., January 15-31 instead of full January)
Mixing monthly and bimester periods inconsistently
Incorrect date ranges for chosen periodicity
Forgetting leap year adjustments for February

Best Practices#

Implement automated period calculation
Validate date ranges against periodicity codes
Maintain consistent periodicity choices
Document business reasons for periodicity selection
Test leap year scenarios

Integration with Other Catalogs#

Related Invoice Elements#

CFDI Usage Codes: Global invoices typically use "G01" (merchandise acquisition) or "G03" (general expenses)
Payment Methods: Usually "PUE" (immediate payment) for consolidated invoices
Tax Regimes: Compatible with all business tax regimes

System Requirements#

Date validation for period boundaries
Leap year calculation capabilities
Period overlap detection
Automated period calculation

Related Documentation#

Invoice Globals - For general global invoice configuration
CFDI Usage Catalog - For compatible usage codes
Payment Methods Catalog - For payment timing options
Tax Regimes Catalog - For applicable tax regimes
Modified at 2025-08-21 00:39:45
Previous
Payment Methods Catalog (Método de Pago)
Next
Invoice Relationships Catalog (Relación entre Facturas)
Built with