v1

latestOpenAPI 3.0.3Proprietaryraw.githubusercontent.com2026-03-067260437.0 KB
Teams

Upload SAT CSD certificates

Upload SAT CSD (Certificado de Sello Digital) certificates to establish SAT connection for CFDI invoicing.

This endpoint accepts multipart form data with the certificate files and password.

Required Files

  • cert: Certificate file (.cer) - The public certificate
  • key: Private key file (.key) - The encrypted private key
  • keyPass: Password for the private key

First-Time Connection

When this is the first SAT connection for a team (no previous SAT setup), the system will automatically initialize default invoice series (G, NC, P, T).

gigstack Connect: Upload SAT certificates for other teams using the team parameter.

post/teams/{id}/sat-connection

Path parameters

idstring required

Team ID to upload SAT certificates for

Query parameters

teamstring

gigstack Connect: Target team ID for multi-team access.

Requires gigstack Connect enabled on your team and shared billing account.

Example: ?team=team_xyz789

Response

SAT connection established successfully

messagestring required

Example response

{
  "message": "SAT connection established successfully",
  "data": {
    "isValid": true,
    "details": {
      "serialNumber": "30001000000500003416",
      "validTo": 1735689600000
    }
  }
}