Skip to Content

Contact updates in Sales — Peru

Technical name: l10n_pe_cs_api_partner_sale

Name
Actualización de Contactos en Ventas - Perú
Summary
Updates the contact SUNAT data from Sales
Description
Automatically refreshes the contact SUNAT data while you work on sales quotations and invoices, and shows status alerts. - Refreshes SUNAT data when you change the customer on a quotation. - Refreshes SUNAT data when you confirm a quotation. - Monthly gate: the same contact is not queried again in the same calendar month. - Only RUC contacts are updated (DNI is skipped). - Shows taxpayer, address, good-taxpayer, withholding-agent and perception-agent alerts on the quotation. - Shows the same alerts on customer/vendor invoices and credit notes.
Author
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
License
OPL-1
Versión
18.0.1.0
Dependencies
  • sale
  • account
  • l10n_pe_cs_api_partner

1. User instructions

This module has no settings of its own. It uses the Cloudia API token from Ajustes (module l10n_pe_cs_api_settings).

SUNAT alerts on a quotation

  1. Open Ventas > a Cotización (or Órdenes de venta).
  2. Set Cliente to a company with identification type RUC.
  3. If that contact was not queried this calendar month, Odoo calls SUNAT and shows Información de Sunat / Actualización de información de Sunat completada.

Alerts under the header (live labels):

  • Estado de Contribuyente = (value) — red; hidden when status is ACTIVO.
  • Estado de Dirección = (value) — yellow; hidden when address status is HABIDO.
  • Buen contribuyente — blue, when SUNAT reports good-taxpayer compliance.
  • Agente de retención — blue, when the contact is a withholding agent.
  • Agente de percepción — blue, when the contact is a perception agent.
  • Exceptuado de percepción — blue, when the contact is perception-exempt.
Quotation with SUNAT banners
COT000941: live banners Buen contribuyente and Agente de retención on a Cotización.

DNI contacts are never sent to the API. A failed API call is logged and does not block Confirmar Cotización.

Same alerts on invoices

The same six banners appear on Factura del cliente, customer credit notes, Factura de proveedor and vendor refunds. They stay hidden while taxpayer status is ACTIVO, address status is HABIDO and the other flags are empty.

Actualización de contactos en Ventas — Perú

Nombre técnico: l10n_pe_cs_api_partner_sale

Nombre
Actualización de Contactos en Ventas - Perú
Resumen
Actualiza la información de Sunat del contacto desde ventas
Descripción
Actualiza automáticamente la información de Sunat del contacto al trabajar con cotizaciones de venta y facturas, mostrando avisos visuales de su estado. - Actualiza el estado Sunat del contacto al cambiarlo en una cotización de venta. - Actualiza el estado Sunat del contacto al confirmar una cotización de venta. - Aplica control mensual para evitar llamadas repetidas a la API para el mismo contacto. - Restringe la actualización a contactos con RUC (excluye DNI). - Muestra en la cotización de venta el estado de contribuyente, domicilio, cumplimiento, agente de retención y agente de percepción del contacto. - Muestra los mismos avisos de estado Sunat en la factura/nota de crédito o débito.
Autor
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
Licencia
OPL-1
Versión
18.0.1.0
Dependencias
  • sale
  • account
  • l10n_pe_cs_api_partner

1. Instrucciones de usuario

Este módulo no tiene ajustes propios. Usa el Token de la API de Cloudia en Ajustes (módulo l10n_pe_cs_api_settings).

Avisos SUNAT en una cotización

  1. Abra Ventas > una Cotización (o Órdenes de venta).
  2. Elija un Cliente con tipo de identificación RUC.
  3. Si el contacto no se consultó este mes, Odoo llama a SUNAT y muestra Información de Sunat / Actualización de información de Sunat completada.

Avisos bajo el encabezado (etiquetas en vivo):

  • Estado de Contribuyente = (valor) — rojo; se oculta si el estado es ACTIVO.
  • Estado de Dirección = (valor) — amarillo; se oculta si el domicilio es HABIDO.
  • Buen contribuyente — azul, si SUNAT reporta cumplimiento de buen contribuyente.
  • Agente de retención — azul, si el contacto es agente de retención.
  • Agente de percepción — azul, si el contacto es agente de percepción.
  • Exceptuado de percepción — azul, si el contacto está exceptuado de percepción.
Cotización con avisos SUNAT
COT000941: avisos en vivo Buen contribuyente y Agente de retención en una Cotización.

Los contactos con DNI no se envían a la API. Si la API falla, se registra el error y no se bloquea Confirmar Cotización.

Los mismos avisos en facturas

Los seis avisos aparecen también en Factura del cliente, notas de crédito de cliente, Factura de proveedor y notas de crédito de proveedor. Permanecen ocultos si el contribuyente está ACTIVO, el domicilio es HABIDO y el resto de flags están vacíos.