Saltar a contenido

Buscar receptor

Busca receptores y empleados del contribuyente por las palabras de su nombre, sin distinguir mayúsculas ni acentos, y también por RFC exacto. Devuelve hasta 10, los más parecidos primero, con id, nombre, kind (receiver o employee), estado (pending si aún faltan sus datos, complete), régimen fiscal, código postal, uso del CFDI, correo, sus datos personales (RFC, identificación fiscal extranjera, CURP, NSS y cuenta bancaria) y missing, lo que le falta para un documento de su tipo. Errores: invalid_input, forbidden.

Alcance (scope): cefidia:read · Características: Solo lectura, Idempotente

Parámetros

Parámetro Tipo Obligatorio Descripción
taxpayer texto No Nombre o RFC del contribuyente. Se puede omitir si solo hay uno.
query texto Sí Palabras del nombre del receptor o empleado o, en una conexión completa, su RFC exacto.
kind texto No receiver solo receptores, employee solo empleados; ambos si se omite.

Esquema de entrada (JSON Schema)

{
  "additionalProperties": false,
  "properties": {
    "taxpayer": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Nombre o RFC del contribuyente. Se puede omitir si solo hay uno.",
      "title": "Taxpayer"
    },
    "query": {
      "description": "Palabras del nombre del receptor o empleado o, en una conexión completa, su RFC exacto.",
      "minLength": 1,
      "title": "Query",
      "type": "string"
    },
    "kind": {
      "anyOf": [
        {
          "enum": [
            "receiver",
            "employee"
          ],
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "receiver solo receptores, employee solo empleados; ambos si se omite.",
      "title": "Kind"
    }
  },
  "required": [
    "query"
  ],
  "title": "FindReceiverInput",
  "type": "object"
}