Defijo

Guarda un servicio o un producto con su código CABYS de 13 dígitos; la tarifa de IVA sale del catálogo de Hacienda. El código tiene que existir en ese catálogo (uno que salió de search_cabys, o que la persona dio y search_cabys confirma): si no está, la herramienta lo rechaza. `precioUnitario` es obligatorio. Sin indicar si el precio incluye IVA, va sin IVA (precioIncluyeIva false); true solo si lo incluye.

create_service

Descarta, de una vez, un borrador que usted creó con create_editor_draft (con la revisión que usted le haya preparado), con la versión que acaba de leer. Nunca uno que empezó otra persona o su asistente, uno cuya revisión preparó una persona, ni una factura aprobada: esos los decide la persona en la app.

discard_editor_draft

Descarta una tarjeta que usted preparó y nadie más tocó, ya sea que falte un dato o que espere el toque. Si se aprobó (emitida, rechazada, fallida al emitir) o es de una persona, un lote o un borrador, la decide ella en la app.

discard_proposal

Emite la factura que muestra la tarjeta de Defijo. Solo el botón «Emitir» de la tarjeta usa esta herramienta, cuando la persona lo toca. Exige un código de un solo uso que la tarjeta recibe de Defijo y que el modelo nunca recibe: emitir es decisión de la persona.

emitir_tarjeta

Consulta cómo va la factura que muestra la tarjeta de Defijo. Solo la propia tarjeta usa esta herramienta, para mostrar el estado a la persona; no emite nada.

estado_tarjeta

Solo para el botón «Guardar negocio» de la tarjeta de Defijo, que toca la persona. El asistente no la llama: guardar el negocio es decisión de la persona.

guardar_negocio_tarjeta

Lee una factura anterior a partir de su XML firmado: emisor, cliente sugerido (y si ya existe), líneas con CABYS e IVA, moneda y totales. No crea el negocio ni el cliente; el cliente se guarda con create_customer.

read_invoice_file

Marca como pagada la venta a crédito que muestra la tarjeta de Defijo. Solo el botón «Marcar pagada» de la tarjeta usa esta herramienta, cuando la persona lo toca. Exige un código que la tarjeta recibe de Defijo (vale 30 minutos, para esta venta y este día) y que el modelo nunca recibe: registrar un pago es decisión de la persona.

marcar_pagada_tarjeta

Prepara la tarjeta «Reenviar por correo» para mandar otra vez una factura ya emitida. `clave` es la de 50 dígitos de una fila de search_documents. La tarjeta muestra la factura, los correos guardados del cliente a los que iría y cómo terminó el último envío; el correo no se elige ni se cambia desde aquí. Solo se reenvía un documento ya aceptado por Hacienda y con a quién enviarse; en ensayo no se envía ningún correo. Si el cliente no tiene correo guardado, la tarjeta no sale y la persona lo agrega en Clientes; después la factura se puede enviar a ese correo, también si se emitió sin destinatarios. Ninguna herramienta envía el correo: la tarjeta lleva un toque y lo hace la persona.

prepare_resend

Prepara la tarjeta «Marcar pagada» para una venta a crédito que un cliente pagó. `documento` es la `clave` de una fila de get_receivables (en ensayo, el id de la venta simulada); `cliente`, el nombre o la clave si solo debe una factura; si debe varias, devuelve la pregunta con las opciones (`candidatas`). `fecha_pago` (AAAA-MM-DD); sin ella es hoy. Solo se paga la factura completa. Ninguna herramienta marca algo como pagado: la tarjeta lleva un toque y lo hace la persona. Si el cliente no debe nada, la respuesta lo dice.

prepare_payment

Prepara la versión corregida de una factura que Hacienda rechazó, a partir de la solución que la persona eligió. Recibe solo lo que esa solución cambia (monto, descripción, cantidad o periodo); todo lo demás se conserva de la factura rechazada. Sin cambios vuelve a preparar con los datos actuales del cliente, del servicio y del negocio, para cuando la causa se corrigió fuera de la factura. Devuelve la tarjeta corregida para revisar; no emite nada.

prepare_correction

Prepara la revisión humana del borrador guardado `draft_id`, con su versión actual, y devuelve la tarjeta con `review_url`. No emite. Si faltan datos, devuelve la pregunta.

prepare_active_editor

Prepara la tarjeta «Enviar N recordatorios» para los clientes atrasados. Sin campos, la tarjeta lista las facturas vencidas (cliente, correos a los que iría, monto y días de atraso); con `cliente`, solo las de ese cliente; con `documento` (la `clave` de una fila de get_receivables), una sola, incluso si todavía no vence. Las que no tienen correo o ya recibieron un recordatorio hoy salen en la tarjeta con su motivo y no se envían. Ninguna herramienta envía el correo: la tarjeta lleva un toque y lo hace la persona.

prepare_reminders

Es para una cuenta que todavía no tiene negocio en Defijo: con un negocio ya creado solo responde que existe, y get_business_status dice cuál es. Prepara el negocio de la persona en Defijo a partir de su cédula: el nombre y el tipo de identificación salen del registro de Hacienda. Cada llamada responde el primer dato que falta, en este orden: la actividad económica (con la lista cuando Hacienda tiene varias), si ya emitió con otro sistema y su sucursal, la dirección y otras señas, el correo y el teléfono. Con todo completo responde la tarjeta del negocio. No guarda nada: la persona lo guarda con «Guardar negocio» en la tarjeta, o en review_url.

prepare_business

Pide el cambio de un dato habitual de la ficha de un cliente guardado («Cambie el correo de Diamond a…», «Dele 30 días de crédito», «Olvide la moneda habitual»): correo, copia a, condición de venta con sus días de crédito, medio de pago o moneda habitual. No guarda nada: el cambio queda pendiente en la ficha y el resultado trae lo que dice hoy, lo que diría y el enlace review_url, donde una persona lo acepta o lo descarta. No cambia nombre, cédula ni dirección: eso se hace en Clientes.

prepare_customer_update

Pide el cambio del precio o la descripción de un servicio guardado («Súbale a ₡25.000 las tutorías», «El precio de la consultoría incluye IVA»). `precio_unitario` es el precio nuevo completo, no cuánto sube. Un precio sin `precio_incluye_iva` conserva el indicador que tiene el servicio. No guarda nada: el cambio queda pendiente en el servicio y el resultado trae lo que dice hoy, lo que diría y el enlace review_url, donde una persona lo acepta o lo descarta. Vale para las facturas nuevas. No cambia el código CABYS, la tarifa de IVA, la unidad, la moneda ni la clave: eso se hace en Servicios.

prepare_service_update

Prepara de una vez un lote de facturas, una por fila, y devuelve el enlace (`review_url`) donde la persona las revisa en una tabla y las emite con un solo toque. `mes_pasado: true` repite las facturas que Hacienda aceptó el mes pasado; `filas` (hasta 200) trae cliente, producto o servicio guardado, y el monto y la cantidad si los hay; sin monto se usa el precio guardado. Cada fila se busca en los clientes y los productos guardados: la que no coincide vuelve en `notas` con el motivo y la persona la agrega en la tabla. No emite nada.

prepare_batch

Prepara un tiquete electrónico, para una venta a un consumidor final que no necesita factura. El cliente es opcional: sin él hacen falta la condición de venta y el medio de pago; con él, esos datos salen de su ficha y no se envían. Cada línea lleva su descripción, el monto o la cantidad y el precio, y el servicio guardado o el código CABYS. Si falta un dato devuelve la pregunta en vez de la tarjeta. Devuelve la tarjeta para revisar; no emite nada.

prepare_ticket

Prepara una factura de compra: el documento con el que el negocio respalda una compra a quien no le dio factura electrónica. Solo dos casos: un servicio de un proveedor del extranjero (el IVA lo declara el negocio y lo puede usar como crédito) o una compra a un productor agropecuario del Régimen Especial Agropecuario. Recibe el proveedor guardado o los datos de uno nuevo; el número y la fecha de la factura o recibo del proveedor; si fue de contado o a crédito y el medio de pago; y cada línea con descripción, monto o cantidad y precio, y su código CABYS, como lo devuelve search_cabys (los servicios guardados son lo que el negocio vende y no sirven para una compra). Si falta un dato, devuelve la pregunta. Devuelve la tarjeta; no emite nada.

prepare_purchase_invoice

Prepara una propuesta de factura y devuelve su tarjeta. Recibe `texto` con el pedido y los campos que ya se entendieron (cliente, descripcion, cantidad, monto, moneda, periodo); el sistema busca el cliente y el servicio entre los guardados. Si falta un dato o hay opciones, devuelve la pregunta en vez de la tarjeta. Repetir el pedido del mismo cliente y mes devuelve la tarjeta que ya espera (`existing: true`); otro monto se cambia con update_proposal.

request_invoice

Prepara la nota de crédito de una factura o un tiquete ya emitido (en ensayo, uno simulado): sin `lineas` lo anula por completo. `documento` es la `clave` de 50 dígitos de una fila de list_documents (en ensayo, su `proposal_id`); `razon`, el motivo en una frase breve (de 5 a 180 caracteres) redactada a partir del pedido. Si ya hay una nota de crédito sin emitir para ese documento, la reemplaza con la razón nueva. Una nota parcial (una devolución, un descuento o un error de monto) lleva en `lineas` las líneas del documento con su cantidad y precio, y en `codigo_referencia` el código que eligió la persona (04 Referencia a otro documento, 06 Devolución de mercancía, 09 Nota de crédito financiera, 14 Corrige monto por error material); sin él, el resultado trae la pregunta. Devuelve la tarjeta para revisar; no emite nada.

prepare_credit_note

Prepara la nota de débito que cobra un monto adicional sobre una factura o un tiquete ya emitido (en ensayo, uno simulado). `documento` es la `clave` de 50 dígitos de una fila de list_documents (en ensayo, su `proposal_id`); `razon`, el motivo en una frase breve (de 5 a 180 caracteres) redactada a partir del pedido; `lineas`, lo que se cobra de más; `codigo_referencia`, el código de referencia de Hacienda que la persona eligió (04 Referencia a otro documento, 10 Nota de débito financiera, 14 Corrige monto por error material). El código lo elige la persona: sin él, la respuesta trae la pregunta con las opciones. La moneda es la del documento original. Devuelve la tarjeta para revisar; no emite nada.

prepare_debit_note

Registra una factura o un tiquete de un proveedor a partir de su XML firmado. Todos los datos salen del XML. No responde la factura: la persona acepta, acepta parcialmente o rechaza desde Compras (`review_url`). Una foto o un PDF no es un XML.

register_received_invoice

Cierre de un mes (AAAA-MM): el IVA por tarifa de las ventas y de las compras (las facturas de compra que el negocio emitió a sus proveedores cuentan como compras, nunca como ventas), el IVA autorepercutido por servicios del extranjero (selfAssessed: lo declara como débito y lo puede usar como crédito en el mismo mes), los documentos que no entran en los totales (emitidos y facturas de compra sin aceptación de Hacienda, facturas recibidas que la persona rechazó con un mensaje receptor aceptado por Hacienda, y tiquetes recibidos, que no dan crédito de IVA según el decreto 44739-H) y los enlaces de descarga (bundle: el Excel y todos los XML en un solo zip para el contador; excel y xml por separado). Una nota de crédito resta en el mes de su propia fecha (criterio de la D-150), así que el total puede diferir del de get_sales, que la descuenta de la factura que anula. Nunca emite, anula ni confirma nada.

get_month_close

Estado del negocio: si puede emitir, en qué ambiente, cuántas facturas esperan una decisión y, en `faltantes`, lo que aún le falta para preparar o emitir cada tipo de factura, con el enlace donde una persona lo resuelve. Con `faltantes_sin_revisar`, `faltantes` no se pudo revisar. No muestra secretos.

get_business_status

Facturas que esperan una decisión de una persona (recurrentes, datos faltantes), cada una con su tarjeta (origin: de dónde salió) y el enlace donde se revisa.

list_pending

Lista las facturas y tiquetes que un proveedor emitió a nombre de este negocio, con su estado (sin respuesta, simulada, enviando, aceptada, aceptada parcialmente o rechazada), de la más reciente a la más vieja, 50 por página; has_more indica que hay otra página. No responde esas facturas: eso lo hace una persona en Compras.

list_received_invoices

Ventas de un rango de fechas (días de Costa Rica), de un cliente o de varios juntos (`customers`): documentos, conteo y totales por moneda, con las notas de crédito descontadas. Sin cliente, `by_customer` da el total de cada uno con su `cliente_id` y `cliente_nombre`.

get_sales

Lo que le deben al negocio: las ventas a crédito (factura, factura de exportación y nota de débito con plazo) que todavía no están marcadas como pagadas, de todas las fechas, la más atrasada primero. Cada una trae el cliente, el monto y la moneda, el día en que vence, su estado (por_cobrar, vence_hoy o vencida, con los días) y el enlace para abrirla en Ventas; también los totales por moneda, que nunca se suman entre sí. Las ventas de contado cuentan como pagadas, un tiquete nunca se debe y una factura anulada con nota de crédito ya no se debe. Con `cliente` solo las de ese cliente.

get_receivables

Lo que Defijo hace por su cuenta y vigila para el negocio. `encargos`: las facturas mensuales que prepara cada mes sin que se lo pidan (las que la persona pidió cobrar cada mes, tipo `plan`, y las que detectó en su historial, tipo `detectado`, salvo las que la persona ya detuvo), cada una con `cliente_nombre`, el servicio, el día en que prepara la próxima, lo último que hizo y dónde detenerla (`detener.url`, un enlace a la tarjeta o a Clientes). `vigilando`: lo que solo avisa (la llave de Hacienda, el cierre del mes, las facturas vencidas), con su estado y el enlace donde se resuelve. Defijo solo PREPARA: la persona aprueba y emite. Ninguna herramienta detiene un encargo: se detiene con «No volver a preparar» en la tarjeta o «Dejar de repetirla» en Clientes. Solo lee.

list_standing_orders

Lista borradores guardados de este negocio, con identidad y versión para retomarlos. No cambia el borrador abierto.

list_editor_drafts

Lista los servicios guardados (descripción, CABYS, tarifa y precio vigente: sirve para "cuánto cobro por X", "cuánto cuesta X" o "qué precio tiene X"); perdona tildes, orden de las palabras y errores de una letra. Texto vacío lista todos.

list_services

Documentos ya emitidos, del más reciente al más antiguo, con `clave`, `tipo` (código de Hacienda; `tipo_nombre` lo dice en palabras), `estado`, `fecha`, `cliente_id` y `cliente_nombre`; una 08 es una compra a un proveedor, nunca una venta, y trae `proveedor_id` y `proveedor_nombre`. Una nota trae `referencia_clave`, el documento al que se refiere; un documento anulado, `cancelled_by`, la nota de crédito que lo anula. Opcionalmente de un año; los 50 más recientes como mucho (search_documents busca uno en particular). En ensayo, `simulated` trae las facturas, tiquetes y compras simulados con su `proposal_id` y, en una venta, si ya tiene nota de crédito.

list_documents

Lee un borrador de factura guardado del negocio (`draft_id`): sus identificadores de línea, su versión y su `cliente_id`.

get_active_editor

Una factura emitida por su `clave` de 50 dígitos (en ensayo, también el `proposal_id` de una venta simulada) con su `estado`, `cliente_id` y `cliente_nombre`, sus líneas (descripción, CABYS, cantidad, unidad, precio unitario, tarifa de IVA, servicio guardado), la nota, las condiciones de pago, su historial reciente (quién la preparó y aprobó, respuesta de Hacienda, envíos por correo) y de dónde salió cada dato. Las líneas, la nota y el pago bastan para repetirla. Si el estado guardado no es final, lo consulta a Hacienda.

get_document

La tarjeta de cualquier factura de este negocio por su `proposal_id`, con su estado: espera, pide un dato, emitida (con consecutivo, clave y envío), rechazada, fallida, descartada o reemplazada (`replaced_by`: la nueva). Dice cómo terminó tras la revisión. No consulta a Hacienda.

get_proposal

Detalle de una factura recibida por su clave de 50 caracteres: proveedor, totales, estado e historial de mensajes receptor. No responde la factura.

get_received_invoice