Referencia del API · MiscellaneousV1

Catálogos

Endpoints de soporte (Miscellaneous): prueba de conexión, información de la cuenta y los catálogos que alimentan CreateTicket — métodos de pago, regímenes fiscales con usos de CFDI y códigos de ticket.

Test

Confirma que la API esté activa y que tu token funcione. Úsalo como primer paso de la integración.

GET https://api.fotofacturas.ai/B2B/MiscellaneousV1/Test
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/Test" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "isSuccess": true,
  "message": "API funcionando correctamente"
}

GetAccountInfo

Obtiene la información de la cuenta: administrador, límites mensuales de tickets, RFCs múltiples permitidos y consumo del mes.

GET https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetAccountinfo
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetAccountinfo" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": {
    "adminUserId": 26,
    "username": "empresa.demo",
    "name": "Juan",
    "pSurname": "Pérez",
    "mSurname": null,
    "email": "usuario@empresa.com",
    "isActive": true,
    "ticketsMonthlyLimit": 1000,
    "ticketsMonthlyLimitPerUser": 50,
    "canPictureInvoice": true,
    "multiRfc": 10,
    "multiRfcPerUser": 5,
    "multiRfcType": "M",
    "ticketsUsed": 21
  },
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

GetTicketPaymentMethods

Retorna los métodos de pago de tickets. El ticketPaymentMethodId se envía en CreateTicket.

GET https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetTicketPaymentMethods
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetTicketPaymentMethods" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": [
    {
      "ticketPaymentMethodId": "01",
      "name": "Efectivo",
      "sequence": 1,
      "isVisible": true
    },
    {
      "ticketPaymentMethodId": "28",
      "name": "Tarjeta de débito",
      "sequence": 2,
      "isVisible": true
    }
  ],
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

La lista completa incluye más métodos (aquí truncada).

GetRegimenFiscalAndCFDI

Retorna los regímenes fiscales y los usos de CFDI válidos para cada uno. regimenFiscalId y usoCFDIId se envían en CreateTicket.

GET https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetRegimenFiscalAndCFDI
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetRegimenFiscalAndCFDI" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": [
    {
      "regimenFiscalId": 626,
      "name": "Régimen Simplificado de Confianza",
      "altName": "",
      "isFisica": true,
      "isMoral": true,
      "cfdi": [
        {
          "usoCFDIId": "G03",
          "name": "Gastos en general",
          "altName": "",
          "sequence": 1
        },
        {
          "usoCFDIId": "G01",
          "name": "Adquisición de mercancías",
          "altName": "",
          "sequence": 4
        },
        {
          "usoCFDIId": "CP01",
          "name": "Pagos",
          "altName": "",
          "sequence": 5
        }
      ]
    }
  ],
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

La lista completa incluye todos los regímenes del catálogo del SAT (aquí truncada).

GetTicketCodes

Regresa los códigos de resultado de un ticket, exitosos y de error, con su descripción y el mensaje que se muestra al usuario. La tabla completa está en la página de códigos de ticket.

GET https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetTicketCodes
Ejemplo · cURL 
curl "https://api.fotofacturas.ai/B2B/MiscellaneousV1/GetTicketCodes" \
  -H "Authorization: Bearer $FF_API_TOKEN"
Respuesta · 200 OK 
{
  "data": [
    {
      "ticketCodeId": 1,
      "category": "Ticket",
      "summary": "Ticket facturado exitosamente",
      "description": "El ticket fue procesado exitosamente por Fotofacturas.",
      "userMessage": "¡Hola! Este ticket fue facturado exitosamente.",
      "isSuccessCode": true,
      "sequence": 1
    },
    {
      "ticketCodeId": 7,
      "category": "Imagen",
      "summary": "Ticket ilegible",
      "description": "La imagen del ticket no permite extraer los datos necesarios.",
      "userMessage": "¡Hola! No podemos leer la información del ticket. Por favor sube una foto más clara y nítida del ticket completo. ¡Gracias!",
      "isSuccessCode": false,
      "sequence": 1
    }
  ],
  "isSuccess": true,
  "message": "Ejecutado correctamente"
}

Respuesta truncada. Consulta la tabla completa en /docs/codigos-de-ticket.