Crear cuenta

Este endpoint permite que la empresa cree cuentas por separado para sus diferentes clientes o departamentos dentro de la empresa, manteniendo el control en la cuenta principal.

Esta estructura es ideal para socios que desean gestionar múltiples operaciones dentro de una única estructura, manteniendo:

• Separación de documentos y usuarios por cuenta;

• Permisos ajustados por equipo o cliente;

• Informes y consumo organizados por unidad;

• Integraciones independientes para cada cuenta (con tokens únicos por cuenta).

Importante: Solo las cuentas con esta funcionalidad activa podrán utilizar este endpoint. Si aún no tienes acceso, ponte en contacto con el equipo comercial.

Cómo funciona

Al hacer una solicitud a este endpoint:

1. Se creará una nueva cuenta (organización) dentro de ZapSign.

2. El propietario de la cuenta principal (quien realiza la solicitud) también será el propietario de la nueva cuenta creada. Esto garantiza control total sobre las cuentas asociadas.

3. El correo electrónico proporcionado en la solicitud se agregará a la nueva cuenta con el rol de Miembro. En caso de no enviar un correo electrónico, la nueva cuenta sólo tendrá un usuario que es el propietario.

   • Un Miembro puede ver todos los documentos de la cuenta, pero no tiene acceso a la configuración de la plataforma.

4. En caso de informar un correo electrónico en la requisición, el usuario invitado recibirá un correo electrónico de ZapSign para crear una contraseña y acceder a su cuenta.

Facturación y gestión de cuentas asociadas

⚠️ Atención: Todo el consumo de las cuentas asociadas será responsabilidad de la cuenta principal (socio).

Esto incluye:

• Creación de documentos;

• Consultas de antecedentes;

• Envío de documentos por WhatsApp;

• Métodos de autenticación avanzada (como reconocimiento facial, certificado digital, etc.).

La cuenta principal tendrá acceso a un panel consolidado con todo el consumo y los documentos generados por las cuentas asociadas.

Si es necesario suspender temporalmente el acceso a una cuenta asociada, puedes utilizar el endpoint Actualizar estado de pago.

Crear una cuenta de socio

POST https://api.zapsign.com.br/api/v1/partner/company/

Headers

Name	Type	Description
Authorization*	string	Token de API precedido por el texto "Bearer". Ejemplo: Bearer c7f35c84-7893-4087-b4fb-d1f06c23

Request Body

Name	Type	Description
email	string	Correo electrónico del nuevo usuario que será añadido como miembro.
country*	string	País de la nueva cuenta. Valores posibles: br, mx, co, pe, cl
lang*	string	Idioma de la nueva empresa. Opciones: "pt-br" (portugués), "es" (español), "en" (inglés). Por defecto: "pt-br"
company_name*	string	Nombre de la nueva empresa.
phone_country	string	Código de país del número de teléfono del nuevo usuario.
phone_number	string	Número de teléfono del nuevo usuario.

Ejemplo de Payload

{
    "email": "email@email",
    "phone_number": "11111111111",
    "phone_country": "55",
    "country": "co",
    "lang": "es",
    "company_name": "New Company LTDA"
}

Response

200 OK – Cuenta creada exitosamente

{
    "id": 543,
    "name": "New Company LTDA",
    "api_token": "010234xx-23ed-44ab-8b57-9XXXXe03cc5e-cc71-4911-bf29-3bxxxx140540",
    "created_at": "2025-04-04T22:35:16.821400Z",
    "credits_balance": 0,
    "lang": "es",
    "timezone": "America/Bogota"
}

400 Bad Request

{
    "message": "Invalid Input",
    "data": {
        "email": [
            "Este campo es requerido."
        ],
        "country": [
            "Este campo es requerido."
        ],
        "lang": [
            "Este campo es requerido."
        ],
        "company_name": [
            "Este campo es requerido."
        ]
    }
}

403 Forbidden – Token inválido

{
    "detail": "No tienes permisos para realizar esta acción."
}

403 Forbidden – Plan inválido

{
    "detail": "Plan necesario para crear empresa parceira."
}

403 Forbidden – Empresa es un socio

{
    "detail": "Acción no permitida para empresa parceira."
}

Cada cuenta creada puede tener su propia integración independiente con la API de ZapSign, completamente separada de las demás.