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"
}