Referencia del API · UserV1

Usuarios

Administra a los usuarios finales de tu integración: altas, actualizaciones, estado y su información fiscal (constancia de situación fiscal).

GetUsersByAssociation

Obtiene el listado de todos los usuarios vinculados a una asociación específica.

GET https://api.fotofacturas.ai/B2B/UserV1/GetUsersByAssociation

Parámetros (query string)

Campo Tipo Requerido Descripción
associationId int Sí ID de la asociación.
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/UserV1/GetUsersByAssociation?associationId=41" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": [
    {
      "userId": 10619,
      "createDate": "2026-01-27T21:06:34.3608",
      "updateDate": "2026-01-27T21:06:34.3608",
      "isActive": true,
      "isDeleted": false,
      "fullName": "Juan Pérez García",
      "email": "usuario@empresa.com",
      "phone": "525512345678",
      "isEmailVerified": false,
      "isPhoneVerified": false,
      "associationId": 41,
      "associationName": "EMPRESA MATRIZ (B2B)",
      "taxInfos": [
        {
          "userId": 10619,
          "userTaxInfoId": 10423,
          "csfFile": "https://…/csf.pdf",
          "startOperationsDate": "2021-02-12T00:00:00",
          "lastStatusChangeDate": "2021-02-12T00:00:00",
          "createDate": "2026-01-27T21:09:23.845268",
          "updateDate": "2026-01-27T21:09:23.845268",
          "isVerified": true,
          "isActive": true
        }
      ],
      "cards": []
    }
  ],
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

Cada objeto de taxInfos incluye campos adicionales de la constancia fiscal (aquí se muestran los principales).

CreateUser

Registra un nuevo usuario en el sistema B2B.

POST https://api.fotofacturas.ai/B2B/UserV1/CreateUser

Body (JSON)

Campo Tipo Requerido Descripción
name string Sí Nombre(s).
pSurname string Sí Apellido paterno.
mSurname string No Apellido materno.
email string Sí Correo del usuario.
phone string Sí Teléfono a 10 dígitos.
phoneCode string Sí Código de país (52 para México).
associationId int Sí Asociación a la que pertenece el usuario.
Ejemplo · cURL 
curl -X POST "https://api.fotofacturas.ai/B2B/UserV1/CreateUser" \
  -H "Authorization: Bearer $FF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Juan",
    "pSurname": "Pérez",
    "mSurname": "García",
    "email": "nuevo.usuario@empresa.com",
    "phone": "5512345678",
    "phoneCode": "52",
    "associationId": 51
  }'
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "Guardado correctamente",
  "data": null
}

UpdateUser

Actualiza la información de un usuario existente.

PUT https://api.fotofacturas.ai/B2B/UserV1/UpdateUser

Body (JSON)

Campo Tipo Requerido Descripción
userId int Sí ID del usuario a actualizar.
name string Sí Nombre(s).
pSurname string Sí Apellido paterno.
mSurname string No Apellido materno.
email string Sí Correo del usuario.
phone string Sí Teléfono a 10 dígitos.
phoneCode string Sí Código de país (52 para México).
associationId int Sí Asociación a la que pertenece el usuario.
Ejemplo · cURL 
curl -X PUT "https://api.fotofacturas.ai/B2B/UserV1/UpdateUser" \
  -H "Authorization: Bearer $FF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 11491,
    "name": "Juan",
    "pSurname": "Pérez",
    "mSurname": "García",
    "email": "usuario@empresa.com",
    "phone": "5512345678",
    "phoneCode": "52",
    "associationId": 52
  }'
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "Guardado correctamente"
}

ChangeUserStatus

Modifica el estado de un usuario dentro del sistema (activar/desactivar).

PUT https://api.fotofacturas.ai/B2B/UserV1/ChangeUserStatus

Body (JSON)

Campo Tipo Requerido Descripción
userId int Sí ID del usuario.
isActive boolean Sí true para activar, false para desactivar.
Ejemplo · cURL 
curl -X PUT "https://api.fotofacturas.ai/B2B/UserV1/ChangeUserStatus" \
  -H "Authorization: Bearer $FF_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 11491,
    "isActive": true
  }'
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "Guardado correctamente"
}

AddUserTaxInfo

Agrega la información fiscal a un usuario. Recibe el archivo de la constancia de situación fiscal (CSF) por multipart/form-data; de ella se extraen RFC, régimen y código postal.

POST https://api.fotofacturas.ai/B2B/UserV1/AddUserTaxInfo

Body (multipart/form-data)

Campo Tipo Requerido Descripción
CSF file Sí Constancia de situación fiscal vigente (PDF, idealmente con menos de 3 meses).
userId int Sí Usuario al que se agrega la información fiscal.
Ejemplo · cURL 
curl -X POST "https://api.fotofacturas.ai/B2B/UserV1/AddUserTaxInfo" \
  -H "Authorization: Bearer $FF_API_TOKEN" \
  -F "CSF=@constancia.pdf" \
  -F "userId=10619"
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "Guardado correctamente"
}

UpdateUserTaxInfo

Actualiza la documentación fiscal previamente cargada de un usuario.

PUT https://api.fotofacturas.ai/B2B/UserV1/UpdateUserTaxInfo

Body (multipart/form-data)

Campo Tipo Requerido Descripción
CSF file Sí Nueva constancia de situación fiscal (PDF).
userTaxInfoId int Sí ID de la información fiscal a actualizar.
Ejemplo · cURL 
curl -X PUT "https://api.fotofacturas.ai/B2B/UserV1/UpdateUserTaxInfo" \
  -H "Authorization: Bearer $FF_API_TOKEN" \
  -F "CSF=@constancia.pdf" \
  -F "userTaxInfoId=10423"
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "Actualizado correctamente"
}