NAME

Net::TinyERP::NotaFiscalServicos - Nota Fiscal de Serviços Eletrônica (NFSe) via TinyERP

MÉTODOS

pesquisar( \%params )

my $res = $tiny->nota_servicos->pesquisar({
    dataInicial => '13/02/2018',
    dataFinal   => '03/11/2018',
});

foreach my $nf (@{ $res->{notas_servico} }) {
    say $nf->{nota_servico}{numero};
    say $nf->{nota_servico}{nome};
}

Para mais informações sobre os parâmetros, consulte a documentação do 'pesquisar' na API.

obter( $id )

Obtém dados sobre uma Nota de Serviços incluida no sistema do TinyERP (via incluir()).

my $res = $tiny->nota_servicos->obter( 354040217 );

if ($res->{status} eq 'OK') {
    my $nf = $res->{nota_servico};
    say $nf->{data_emissao};
    say $nf->{cliente}{cep};
    say $nf->{servico}{descricao};
}

Para mais informações sobre os parâmetros, consulte a documentação do 'obter' na API.

consultar( $id )

Parecida com obter(), esse método consulta na prefeitura o andamento de uma Nota de Serviços com situação 4 (Lote não processado). Note que essa consulta é síncrona, então chamadas a essa API podem demorar e até mesmo gerar timeouts, caso o serviço da sua prefeitura esteja com problemas de comunicação com a Tiny.

my $res = $tiny->nota_servicos->consultar( 354040217 );

if ($res->{status} eq 'OK') {
    my $nf = $res->{nota_servico};
    say $nf->{id};
    say $nf->{situacao};
}

Para mais informações sobre os parâmetros, consulte a documentação do 'consultar' na API.

emitir( $id )

emitir( \%params )

Envia a Nota de Serviços selecionada à SEFAZ associada, criando uma NFSe com valor fiscal.

# equivalente a $tiny->nota_servicos->emitir({ id => '354040217' });
my $res = $tiny->nota_fiscal->emitir( '354040217' );

if ($res->{status} eq 'OK') {
    my $nf = $res->{nota_servico};
    say $nf->{situacao};
    say $nf->{link_impressao};
}

Para mais informações sobre os parâmetros, consulte a documentação do 'emitir' na API. Note que a Tiny chama de "enviar", mas para mantermos consistência com a interface de NFe, mantemos o nome "emitir".

incluir( \%params )

Adiciona uma nova Nota de Serviços ao sistema do Tiny. Note que, após a inclusão, você ainda precisa emitir() a nota para que ela tenha valor fiscal.

my $res = $api->nota_servicos->incluir({
    data_emissao => '21/04/2019',
    cliente => {
        nome => 'Maria Silva',
        atualizar_cliente => 'N',
    },
    servico => {
        descricao => 'Assinatura do plano PRO',
        valor_servico => 29.95,
        codigo_lista_servico => '10.02.01',
    },
    descontar_iss_total => 'N',
});

if ($res->{status} eq 'OK') {
    say $res->{registros}[0]{registro}{status};
    say $res->{registros}[0]{registro}{id};
    say $res->{registros}[0]{registro}{numeroRPS};
}

Para mais informações sobre os parâmetros, consulte a documentação do 'incluir' na API.

VEJA TAMBÉM

Net::TinyERP