Upload CSF PDF to create or update client

POST

https://api.gigstack.io/v2/clients/csf

Upload a CSF (Constancia de Situación Fiscal) PDF file from SAT to automatically extract fiscal information and create a new client or update an existing one.

How it works:

Upload the CSF PDF file as multipart/form-data

The system extracts RFC and CIF from the PDF

Validates the fiscal information against SAT

Creates a new client or updates an existing one with the fiscal data

Query Parameters:

client_id (optional): If provided, updates the existing client. If omitted, creates a new client.

Extracted Information:

Legal name (Razón Social)

RFC (Tax ID)

Fiscal regime (Régimen Fiscal)

Fiscal type (company/individual)

Fiscal status

Complete address (street, exterior/interior number, neighborhood, city, state, zip code)

gigstack Connect: Create or update clients for other teams using the team parameter.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Query Params

Body Params multipart/form-dataRequired

Responses

🟢200OK

application/json

Client updated successfully with CSF data

Body

🟢201Created

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.gigstack.io/v2/clients/csf?team&client_id=client_1234567890' \
--form 'file=@""'

Response Example

200 - Success Example

{
    "message": "Client updated with CSF data",
    "data": {
        "id": "client_1234567890",
        "name": "Empresa Ejemplo SA de CV",
        "legal_name": "Empresa Ejemplo SA de CV",
        "tax_id": "EEM010101ABC",
        "rfc": "EEM010101ABC",
        "tax_system": "601",
        "address": {
            "street": "Av. Reforma",
            "exterior": "123",
            "neighborhood": "Centro",
            "city": "Ciudad de México",
            "state": "CDMX",
            "zip": "06000",
            "country": "MEX"
        },
        "is_valid": false,
        "livemode": false,
        "created_at": 1677651234,
        "team": "team_1234567890",
        "owner": "user_1234567890",
        "from": "api",
        "metadata": {
            "rfc": "EEM010101ABC",
            "fiscal_type": "company",
            "fiscal_status": "Activo"
        }
    }
}

Modified at 2026-01-23 18:33:49

Delete client

Services API Guide