Moloni

Bom dia,

É possível emitir um documento automaticamente sempre que um pedido é finalizado.

Para tal, no menu de configurações do Moloni, ative a opção de “Criação automática de documentos”. Em seguida, defina os tipos de documentos que pretende gerar automaticamente, como faturas ou recibos, e ajuste preferências adicionais, como envio automático por e-mail e sincronização de produtos. Por fim, guarde as configurações.

Estimado cliente,

Antes demais, agradecemos as suas palavras. Trabalhamos diariamente para dar aos nossos utilizadores as melhores ferramentas do mercado para que todo o trabalho seja mais fácil.

Relativamente ao erro reportado, pode parecer estranho por ser uma sequência de números de 1 até 9, mas o contribuinte “123456789” é de facto um contribuinte válido e associado a uma entidade portuguesa 😉

Por esse motivo, não podemos bloquear o contribuinte e dá-lo como inválido.

Cumprimentos,

Bom dia.

Os produtos podem ser movidos de categoria na sincronização de artigos (WooCommerce -> Moloni), e não na sincronização de stocks. Esta situação pode ocorrer se tiver a opção “Atualizar artigos” ativa nas configurações do plugin.

Se tiver a opção ativa, poderá, por exemplo, implementar um filtro que altera os valores de atualização de artigos. Neste filtro podemos remover a categoria. Segue o seguinte filtro como exemplo de implementação.

add_filter('moloni_before_moloni_product_update', [$this, 'moloni_before_moloni_product_update']); function moloni_before_moloni_product_update($props) { if (isset($props['category_id'])) { unset($props['category_id']); } return $props; }

(referência: https://github.com/moloni-pt/woocommerce/blob/4ea23a5ef9230047af25a38e24aa953f38c928f6/src/Controllers/Product.php#L142)

Bom dia.

O plugin tem disponível vários filtros (hooks) que permitem personalizar a criação de documentos. Se pretendem acrescentar informações nas observações do documento, poderá ser feito através do filtro (hook) “moloni_before_insert_document”.

Este filtro corre mesmos antes de inserir o documento na conta Moloni. Referência do filtro: https://github.com/moloni-pt/woocommerce/blob/4ea23a5ef9230047af25a38e24aa953f38c928f6/src/Controllers/Documents.php#L267

Sugerimos a implementação deste filtro:

function moloni_before_insert_document($document_builder) { 
// Secção meramente demonstrativa 
    $adse_information = "Nome: XXX"; 
    $adse_information .= "<br>"; // Quebra de linha 
    $adse_information = "Número: XXX"; 
    $document_builder->notes = $adse_information; 
} 

add_filter('moloni_before_insert_document', 'moloni_before_insert_document', 10, 1);

Caso necessite de mais ajuda não hesite em entrar em contacto.

Bom dia,

Na atualização disponibilizada hoje (versão 4.7.1), já acrescentámos a opção nas configurações do plugin de selecionar qual é o estado em que pretende que os documentos sejam gerados, o que vai de encontro com o que sugeriu.

No seguimento das alterações que foram efetuadas após a sua sugestão, se assim entender, agradecíamos que revisse também a sua classificação dada ao plugin Moloni.

Estamos sempre abertos a todas as sugestões enviadas pelos nossos utilizadores, e sempre que forem possíveis de implementar, tratamos de as implementar o mais rapidamente possível.

Correto, o código da AT só está disponível em documentos de transporte.

Uma vez que é preciso gerar uma Guia de Transporte + Documento de Faturação, a melhor solução é ativar a opção de gerar automaticamente documentos de transporte no plugin Moloni.

Com essa opção ativa, o próprio plugin trata de gerar uma Guia de Transporte e a respetiva Fatura (ou Fatura/Recibo), associando as duas.

Boa tarde,

O código AT de transporte apenas é gerado para documentos do tipo “Guia de transporte”. O código pode ser obtido no campo transport_code após ser feito o pedido documents/getOne à API Moloni.

Visto que o código AT de transporte apenas é gerado quando um documento é gerado no estado “fechado”, teria de usar a ação moloni_after_close_document.

Dentro da função que registou terá de fazer um pedido para obter os dados do documento como, por exemplo:

add_filter( 'moloni_after_close_document' , 'moloniAfterCloseDocument' );

function moloniAfterCloseDocument( $documentBuilder ) {
    $documentId = documentBuilder->getDocumentId() ?? 0;

    if ($documentId <= 0) {
        return $documentBuilder;
    }

    $requestProps = [
        'document_id' => $documentId
    ];

    $document = \Moloni\Curl::simple('documents/getOne', $requestProps);

    if (empty($document) || !is_array($document)) {
        return $documentBuilder;
    }

    $transportCode = $document['transport_code'] ?? '';

    if (!empty($transportCode)) {
        // custom stuff
    }

    return $documentBuilder;
}

Caso necessite de mais ajuda não hesite em entrar em contacto.