sunat_cpe_facturaloperu 0.1.2
sunat_cpe_facturaloperu: ^0.1.2 copied to clipboard
Adaptador REST JSON de FacturaloPeru y Facturador PRO (Smart / APIPeru) para facturación electrónica SUNAT (CPE) y consultas RUC/DNI en Dart puro.
sunat_cpe_facturaloperu #
Adaptador oficial de FacturaloPeru / Facturador PRO (PRO X, PRO 4, PRO 5, Smart, APIPeru) para facturación electrónica SUNAT (Perú) en Dart 3 puro, implementando los contratos de sunat_cpe_core.
Características Principales #
- Endpoints Semánticos RESTful:
/api/documentsy/api/documents/status: Emisión síncrona y consulta de estado para Facturas (01), Boletas (03), Notas de Crédito (07) y Notas de Débito (08)./api/summariesy/api/summaries/status: Envío asíncrono de Resumen Diario (RC) y consulta de ticket./api/voidedy/api/voided/status: Envío asíncrono de Comunicación de Baja (RA) y consulta de ticket./api/dispatchesy/api/dispatches/status: Envío asíncrono de Guías de Remisión (09/31) y consulta de ticket./api/retentions: Emisión de Comprobantes de Retención (20) y Percepción (40).
- Correlativo Autoincremental en Servidor (
allowServerAutoIncrement): Permite enviar"numero_documento": "#"cuando el correlativo del comprobante es0, delegando la numeración al servidor Facturador PRO. - Consulta de Padrón SUNAT y RENIEC (
lookupTaxpayer): Consulta auxiliar de RUC (/api/service/ruc/{ruc}) y DNI (/api/service/dni/{dni}) devolviendoFacturaloTaxpayerInfo(razón social, estado, condición, dirección y ubigeo). - Mapeo de Estados (
state_type_id01..13): Traduce las respuestas JSON anidadas (data.state_type_id,cdr_response,links.xml/pdf/cdr) aCpeResult<CpeEmissionResponse>.
Instalación #
dependencies:
sunat_cpe_core: ^0.1.2
sunat_cpe_facturaloperu: ^0.1.2
Ejemplo Rápido #
import 'package:sunat_cpe_facturaloperu/sunat_cpe_facturaloperu.dart';
Future<void> main() async {
final provider = FacturaloProvider(
config: FacturaloConfig(
baseUri: Uri.parse('https://tu-instancia.facturaloperu.com'),
apiToken: 'TU_BEARER_TOKEN',
allowServerAutoIncrement: true,
),
);
// Consulta de RUC en el padrón SUNAT
final rucInfo = await provider.lookupTaxpayer(
documentNumber: '20100066603',
isRuc: true,
);
print(rucInfo);
}
Consulta el archivo example/main.dart para ver un ejemplo completo y ejecutable offline con todos los flujos soportados.