Ir al contenido

Update contacts from purchases — Peru

Technical name: l10n_pe_cs_api_partner_purchase

Name
Actualiza Contactos en Compras - Perú
Summary
Updates the contact’s Sunat information from purchases
Description
When you change the vendor on a purchase order or confirm it, the module refreshes Sunat data on RUC partners (via l10n_pe_cs_api_partner), at most once per calendar month. The order and vendor bills show taxpayer / address status and agent flags.
Author
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
License
OPL-1
Version
18.0.1.0
Dependencies
  • purchase
  • l10n_pe_cs_api_partner

1. User instructions

There is nothing extra to configure here (Sunat credentials live on l10n_pe_cs_api_partner). Banners appear as soon as the partner has Sunat fields filled.

Alerts on the orden de compra

Open Compras → Órdenes de compra. Above the form:

  • Red: Estado de Contribuyente = … when the status is not ACTIVO (live: BAJA DE OFICIO on ACEROTEC S.A.C.).
  • Yellow: Estado de Dirección = … when the address status is not HABIDO (live: NO HABIDO).
  • Blue info: Buen contribuyente, Agente de Retención, Agente de Percepción, Exento de Percepción when those flags are set (live on OC000197 / 3M PERU S A: Agente de Retención).
Purchase order taxpayer and address alerts
OC000057: Estado de Contribuyente = BAJA DE OFICIO and Estado de Dirección = NO HABIDO.
Purchase order Agente de Retención banner
OC000197, 3M PERU S A. Blue banner Agente de Retención.

Same banners on the factura de proveedor

On customer and vendor invoices/credit notes the same alerts show (live F001-00001251 also Agente de Retención).

Vendor bill Agente de Retención banners
Factura de proveedor F001-00001251, 3M PERU S A, Publicado. Banner Agente de Retención.

When Sunat data is refreshed

  • Changing the vendor on an orden de compra, or confirming it, calls update_contacts() on the commercial partner.
  • Only identification type RUC is updated. DNI and partners without an id type are skipped.
  • If date_last_updated is already in the current month, the API is not called again.
  • Confirming several orders for the same vendor updates that partner once.
  • A successful refresh can show the notification Información de SUNAT / Información de SUNAT actualizada correctamente.
  • API errors are logged and do not block confirm.

Actualiza contactos en compras — Perú

Nombre técnico: l10n_pe_cs_api_partner_purchase

Nombre
Actualiza Contactos en Compras - Perú
Resumen
Actualiza la información de Sunat del contacto desde compras
Descripción
Al cambiar el proveedor en una orden de compra o al confirmarla, el módulo refresca los datos Sunat de socios con RUC (vía l10n_pe_cs_api_partner), como máximo una vez por mes calendario. La orden y las facturas de proveedor muestran estado de contribuyente / domicilio y banderas de agente.
Autor
Cloudia
Copyright
Copyright (c) 2025-Present Cloudia Systems S.A.C.
Licencia
OPL-1
Versión
18.0.1.0
Dependencias
  • purchase
  • l10n_pe_cs_api_partner

1. Instrucciones de usuario

Aquí no hay ajustes extra (las credenciales Sunat están en l10n_pe_cs_api_partner). Los avisos aparecen en cuanto el socio tiene datos Sunat.

Avisos en la orden de compra

Abra Compras → Órdenes de compra. Encima del formulario:

  • Rojo: Estado de Contribuyente = … si el estado no es ACTIVO (en vivo: BAJA DE OFICIO en ACEROTEC S.A.C.).
  • Amarillo: Estado de Dirección = … si el domicilio no es HABIDO (en vivo: NO HABIDO).
  • Azul: Buen contribuyente, Agente de Retención, Agente de Percepción, Exento de Percepción cuando aplican (en vivo en OC000197 / 3M PERU S A: Agente de Retención).
Avisos de contribuyente y dirección en la orden de compra
OC000057: Estado de Contribuyente = BAJA DE OFICIO y Estado de Dirección = NO HABIDO.
Aviso Agente de Retención en la orden de compra
OC000197, 3M PERU S A. Aviso azul Agente de Retención.

Los mismos avisos en la factura de proveedor

En facturas y notas de crédito de cliente o proveedor se muestran los mismos avisos (en vivo F001-00001251 también Agente de Retención).

Avisos Agente de Retención en la factura de proveedor
Factura de proveedor F001-00001251, 3M PERU S A, Publicado. Aviso Agente de Retención.

Cuándo se refrescan los datos Sunat

  • Al cambiar el proveedor en la orden de compra o al confirmarla se llama update_contacts() del socio comercial.
  • Solo se actualiza el tipo RUC. DNI y socios sin tipo de documento se omiten.
  • Si date_last_updated ya es de este mes, no se vuelve a llamar a la API.
  • Confirmar varias órdenes del mismo proveedor actualiza ese socio una sola vez.
  • Un refresco correcto puede mostrar Información de SUNAT / Información de SUNAT actualizada correctamente.
  • Los errores de API se registran y no bloquean la confirmación.