Skip to main content

sunat_cpe_facturaloperu 0.1.2 copy "sunat_cpe_facturaloperu: ^0.1.2" to clipboard
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.

example/main.dart

import 'dart:convert';
import 'dart:typed_data';

import 'package:sunat_cpe_core/sunat_cpe_core.dart';
import 'package:sunat_cpe_facturaloperu/sunat_cpe_facturaloperu.dart';

/// Cliente HTTP simulado 100% offline para demostrar todos los flujos de FacturaloPeru / Facturador PRO.
final class _SimulatedFacturaloHttpClient implements CpeHttpClient {
  int _summaryStatusAttempts = 0;

  @override
  Future<CpeHttpResponse> send(CpeHttpRequest request) async {
    final path = request.uri.path;

    // 1. Emisión de Factura (/api/documents)
    if (path.endsWith('/api/documents')) {
      final body = jsonDecode(request.body as String) as Map<String, dynamic>;
      final serie = body['serie_documento'];
      final numero = body['numero_documento'];
      final assignedNumber = numero == '#' ? '00000125' : numero.toString();

      return _jsonResponse({
        'success': true,
        'data': {
          'number': '$serie-$assignedNumber',
          'filename': '20100066603-01-$serie-$assignedNumber',
          'external_id': 'f81d4fae-7dec-11d0-a765-00a0c91e6bf6',
          'state_type_id': '05',
          'state_type_description': 'Aceptado',
          'hash': 'kL9mN2pQ4rS6tU8vW0xY2zA4bC6=',
          'qr':
              '20100066603|01|$serie|$assignedNumber|180.00|1180.00|2026-11-04|6|20600695771|',
          'cdr_response': {
            'code': '0',
            'description':
                'La Factura numero $serie-$assignedNumber, ha sido aceptada',
            'notes': <String>[],
          },
        },
        'links': {
          'xml': 'https://demo.facturaloperu.com/downloads/xml/f81d4fae',
          'pdf': 'https://demo.facturaloperu.com/downloads/pdf/f81d4fae',
          'cdr': 'https://demo.facturaloperu.com/downloads/cdr/f81d4fae',
        },
      });
    }

    // 2. Resumen Diario (/api/summaries) y Polling (/api/summaries/status)
    if (path.endsWith('/api/summaries')) {
      return _jsonResponse({
        'success': true,
        'data': {
          'external_id': 'ext-rc-20261104-01',
          'ticket': '202600998877665',
        },
      });
    }

    if (path.endsWith('/api/summaries/status')) {
      _summaryStatusAttempts++;
      if (_summaryStatusAttempts == 1) {
        return _jsonResponse({
          'success': true,
          'data': {
            'state_type_id': '03',
            'state_type_description': 'Enviado a SUNAT (En Proceso)',
          },
        });
      }
      return _jsonResponse({
        'success': true,
        'data': {
          'filename': 'R-20100066603-RC-20261104-1',
          'state_type_id': '05',
          'state_type_description': 'Aceptado',
          'cdr_response': {
            'code': '0',
            'description': 'El Resumen Diario RC-20261104-1 ha sido aceptado',
          },
        },
      });
    }

    // 3. Comunicación de Baja (/api/voided) y Guía de Remisión (/api/dispatches)
    if (path.endsWith('/api/voided')) {
      return _jsonResponse({
        'success': true,
        'data': {
          'external_id': 'ext-ra-20261104-01',
          'ticket': '202600112233445',
        },
      });
    }

    if (path.endsWith('/api/dispatches')) {
      return _jsonResponse({
        'success': true,
        'data': {
          'external_id': 'ext-gre-t001-01',
          'ticket': 'GRE-TICKET-998877',
        },
      });
    }

    // 4. Consulta de Padrón SUNAT (RUC) y RENIEC (DNI)
    if (path.endsWith('/api/service/ruc/20100066603')) {
      return _jsonResponse({
        'success': true,
        'data': {
          'ruc': '20100066603',
          'nombre_o_razon_social': 'CORPORACION TECNOLOGICA DEL PERU S.A.C.',
          'estado': 'ACTIVO',
          'condicion': 'HABIDO',
          'direccion': 'AV. JAVIER PRADO ESTE 4500, SANTIAGO DE SURCO',
          'ubigeo': '150140',
        },
      });
    }

    if (path.endsWith('/api/service/dni/45678912')) {
      return _jsonResponse({
        'success': true,
        'data': {
          'numero': '45678912',
          'name': 'CARLOS ALBERTO MENDOZA VARGAS',
          'estado': 'ACTIVO',
          'condicion': 'HABIDO',
          'direccion': 'JR. LAS CAMELIAS 320, SAN ISIDRO',
          'ubigeo': '150131',
        },
      });
    }

    return _jsonResponse({
      'success': false,
      'message': 'Ruta no simulada: $path',
    });
  }

  CpeHttpResponse _jsonResponse(Map<String, dynamic> map) {
    return CpeHttpResponse(
      statusCode: 200,
      headers: const {'content-type': 'application/json; charset=utf-8'},
      bodyBytes: Uint8List.fromList(utf8.encode(jsonEncode(map))),
    );
  }

  @override
  void close() {}
}

Future<void> main() async {
  print('===================================================================');
  print(' DEMO OFFLINE: sunat_cpe_facturaloperu (Facturador PRO / Smart)');
  print(
    '===================================================================\n',
  );

  final provider = FacturaloProvider(
    config: FacturaloConfig(
      baseUri: Uri.parse('https://demo.facturaloperu.com'),
      apiToken: 'BEARER_TOKEN_DEMO_PRO_5',
      pdfFormat: 'a4',
      sendEmail: true,
      allowServerAutoIncrement: true,
    ),
    httpClient: _SimulatedFacturaloHttpClient(),
  );

  const issuer = CompanyParty(
    ruc: '20100066603',
    legalName: 'CORPORACION TECNOLOGICA DEL PERU S.A.C.',
    address: Address(
      ubigeo: '150140',
      streetLine: 'AV. JAVIER PRADO ESTE 4500',
    ),
  );

  // ---------------------------------------------------------------------------
  // 1. Emisión de Factura (01) con FacturaloProvider.sendDocument (/api/documents)
  //    y demostración de allowServerAutoIncrement: true (number: "#")
  // ---------------------------------------------------------------------------
  print('1. Emisión de Factura (01) en /api/documents y modo correlativo "#"');
  final invoice = InvoiceDocument(
    id: const DocumentId(
      issuerRuc: '20100066603',
      type: CpeDocumentType.factura,
      series: 'F001',
      number: 125,
    ),
    issueDate: DateTime(2026, 11, 4),
    issuer: issuer,
    customer: const CustomerParty(
      documentType: IdentityDocumentType.ruc,
      documentNumber: '20600695771',
      legalName: 'INVERSIONES INDUSTRIALES ANDINAS S.A.C.',
      email: 'facturacion@andinas.pe',
    ),
    currency: CurrencyCode.pen,
    items: [
      CpeLineItem(
        lineNumber: 1,
        internalCode: 'SRV-CLOUD-01',
        sunatProductCode: '81112105',
        unitCode: 'ZZ',
        description: 'SUSCRIPCION ANUAL SERVIDOR DEDICADO',
        quantity: Decimal.fromInt(1),
        unitValue: Decimal.parse('1000.00'),
        unitPrice: Decimal.parse('1180.00'),
        lineExtensionAmount: Decimal.parse('1000.00'),
        taxableBaseAmount: Decimal.parse('1000.00'),
        igvAffectation: IgvAffectationType.gravadoOperacionOnerosa,
        igvPercentage: Decimal.parse('18.00'),
        igvAmount: Decimal.parse('180.00'),
        totalLineTaxAmount: Decimal.parse('180.00'),
        totalLineAmount: Decimal.parse('1180.00'),
      ),
    ],
    totals: MonetaryTotals(
      totalGravadas: Decimal.parse('1000.00'),
      totalIgv: Decimal.parse('180.00'),
      totalValorVenta: Decimal.parse('1000.00'),
      totalImpuestos: Decimal.parse('180.00'),
      totalPrecioVenta: Decimal.parse('1180.00'),
      importeTotalPagar: Decimal.parse('1180.00'),
    ),
  );

  // Demostración de allowServerAutoIncrement: true cuando el correlativo es 0:
  final draftWithAutoIncrement = InvoiceDocument(
    id: invoice.id.copyWith(number: 0),
    issueDate: invoice.issueDate,
    issuer: invoice.issuer,
    customer: invoice.customer,
    currency: invoice.currency,
    items: invoice.items,
    totals: invoice.totals,
  );
  final mappedAutoJson = provider.documentMapper.mapSalesDocument(
    draftWithAutoIncrement,
    provider.config,
  );
  print(
    '   -> Modo allowServerAutoIncrement (number=0) mapea numero_documento: '
    '"${mappedAutoJson['numero_documento']}"',
  );

  final invoiceResponse = (await provider.sendDocument(invoice)).getOrThrow();
  print('   -> Estado SUNAT: ${invoiceResponse.status.name}');
  print('   -> Descripción CDR: ${invoiceResponse.cdr?.description}');
  print('   -> External ID: ${invoiceResponse.ticket}');
  print('   -> URL descarga PDF: ${invoiceResponse.pdfDownloadUrl}\n');

  // ---------------------------------------------------------------------------
  // 2. Emisión de Resumen Diario (/api/summaries) y Polling (/api/summaries/status)
  // ---------------------------------------------------------------------------
  print('2. Emisión de Resumen Diario (RC) y Polling Asíncrono');
  final summary = DailySummaryDocument(
    id: const DocumentId(
      issuerRuc: '20100066603',
      type: CpeDocumentType.resumenDiario,
      series: 'RC-20261104',
      number: 1,
    ),
    issueDate: DateTime(2026, 11, 4),
    referenceDate: DateTime(2026, 11, 4),
    issuer: issuer,
    lines: [
      DailySummaryLine(
        lineNumber: 1,
        documentType: CpeDocumentType.boleta,
        series: 'B001',
        number: 10,
        status: SummaryLineStatus.adicionar,
        customerDocumentType: IdentityDocumentType.dni,
        customerDocumentNumber: '45678912',
        totalGravadas: Decimal.parse('100.00'),
        totalIgv: Decimal.parse('18.00'),
        totalSaleAmount: Decimal.parse('118.00'),
      ),
    ],
  );

  final summaryTicket = (await provider.sendDailySummary(summary)).getOrThrow();
  print('   -> Ticket RC generado: ${summaryTicket.ticket}');

  final polledSummary = (await provider.pollTicketUntilDone(
    summaryTicket.ticket,
    referenceId: summary.id,
    config: const PollingConfig(
      initialDelay: Duration(milliseconds: 10),
      maxAttempts: 3,
    ),
  )).getOrThrow();
  print('   -> Código CDR tras polling: ${polledSummary.responseCode}');
  print('   -> Mensaje CDR: ${polledSummary.description}\n');

  // ---------------------------------------------------------------------------
  // 3. Comunicación de Baja (/api/voided) y Guía de Remisión (/api/dispatches)
  // ---------------------------------------------------------------------------
  print('3. Comunicación de Baja (RA) y Guía de Remisión Remitente (09)');
  final voided = VoidedDocument(
    id: const DocumentId(
      issuerRuc: '20100066603',
      type: CpeDocumentType.comunicacionBaja,
      series: 'RA-20261104',
      number: 1,
    ),
    issueDate: DateTime(2026, 11, 4),
    referenceDate: DateTime(2026, 11, 3),
    issuer: issuer,
    lines: const [
      VoidedLine(
        lineNumber: 1,
        documentType: CpeDocumentType.factura,
        series: 'F001',
        number: 99,
        voidReason: 'ERROR EN RUC DEL RECEPTOR',
      ),
    ],
  );
  final voidedTicket = (await provider.sendVoidedDocument(voided)).getOrThrow();
  print('   -> Ticket Baja (/api/voided): ${voidedTicket.ticket}');

  final guide = DespatchAdviceDocument(
    id: const DocumentId(
      issuerRuc: '20100066603',
      type: CpeDocumentType.guiaRemisionRemitente,
      series: 'T001',
      number: 15,
    ),
    issueDate: DateTime(2026, 11, 4),
    issuer: issuer,
    recipient: const CustomerParty(
      documentType: IdentityDocumentType.ruc,
      documentNumber: '20600695771',
      legalName: 'INVERSIONES INDUSTRIALES ANDINAS S.A.C.',
    ),
    transferReason: DespatchReasonCode.venta,
    transportMode: TransportModeCode.transportePublico,
    transferStartDate: DateTime(2026, 11, 5),
    grossWeight: Decimal.parse('120.50'),
    originAddress: const Address(
      ubigeo: '150140',
      streetLine: 'AV. JAVIER PRADO ESTE 4500',
    ),
    deliveryAddress: const Address(
      ubigeo: '150101',
      streetLine: 'AV. ARGENTINA 1250, LIMA',
    ),
    items: [
      DespatchLineItem(
        lineNumber: 1,
        internalCode: 'EQ-RACK-01',
        description: 'GABINETE DE SERVIDORES 42U',
        quantity: Decimal.fromInt(2),
      ),
    ],
  );
  final guideTicket = (await provider.sendDespatchAdvice(guide)).getOrThrow();
  print('   -> Ticket Guía (/api/dispatches): ${guideTicket.ticket}\n');

  // ---------------------------------------------------------------------------
  // 4. Consulta de Padrón SUNAT (RUC) y RENIEC (DNI)
  // ---------------------------------------------------------------------------
  print('4. Consulta de Padrón SUNAT (RUC) y RENIEC (DNI)');
  final rucInfo = (await provider.lookupTaxpayer(
    documentNumber: '20100066603',
    isRuc: true,
  )).getOrThrow();
  print(
    '   -> RUC ${rucInfo.documentNumber}: ${rucInfo.nameOrLegalName} '
    '[Estado: ${rucInfo.status}, Condición: ${rucInfo.condition}, '
    'Dirección: ${rucInfo.address}, Ubigeo: ${rucInfo.ubigeo}]',
  );

  final dniInfo = (await provider.lookupTaxpayer(
    documentNumber: '45678912',
    isRuc: false,
  )).getOrThrow();
  print(
    '   -> DNI ${dniInfo.documentNumber}: ${dniInfo.nameOrLegalName} '
    '[Estado: ${dniInfo.status}, Condición: ${dniInfo.condition}, '
    'Dirección: ${dniInfo.address}, Ubigeo: ${dniInfo.ubigeo}]',
  );
}
0
likes
160
points
579
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Adaptador REST JSON de FacturaloPeru y Facturador PRO (Smart / APIPeru) para facturación electrónica SUNAT (CPE) y consultas RUC/DNI en Dart puro.

Repository (GitHub)
View/report issues

Topics

#sunat #cpe #facturacion-electronica #ose #peru

License

MIT (license)

Dependencies

decimal, sunat_cpe_core

More

Packages that depend on sunat_cpe_facturaloperu