Número por extenso (qualquer idioma)
O robô «Número por extenso» escreve um número com palavras em processos de negócios e robôs do Bitrix24 (Alaio): 10000 vira «Dez mil» e 2021 vira «Dois mil e vinte e um». Idiomas: inglês, espanhol, português, francês, italiano, alemão, polonês e turco. É possível acrescentar a palavra da moeda e os centavos como fração, por exemplo 75/100.
O robô serve para faturas, contratos e cheques em que o valor também precisa aparecer por extenso. A entrada é um número de um campo do negócio ou da fatura, um idioma e, se quiser, a palavra da moeda — por exemplo reais, euros ou pesos. Nos idiomas com gênero gramatical, informe o gênero da palavra da moeda para que o número concorde com ela: «veintiún pesos», mas «veintiuna libras». A parte decimal é escrita como fração, por exemplo 75/100, formato comum em cheques e faturas, ou é descartada. O número pode ter ponto ou vírgula decimal, e espaços entre grupos de dígitos são aceitos. Retorna o valor completo por extenso e, separadamente, a parte inteira por extenso. Use o resultado num modelo de documento, num e-mail ou num campo de texto nas próximas etapas do processo.
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Número | string | sim | |
| Idioma | select | sim | en |
| Palavra da moeda (opcional), ex.: reais | string | — | |
| Gênero da palavra da moeda | select | — | masculine |
| Parte decimal | select | — | auto |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Número por extenso | string |
| Parte inteira por extenso | string |
| Sucesso | bool |
| Erro | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Não foi possível ler o número «{raw}»
- O número «{raw}» é grande demais: a parte inteira pode ter no máximo 15 dígitos
- Idioma desconhecido «{raw}»
Cenário: uma fatura para um cliente no México
- O valor do negócio é 10500,75
- O robô com idioma Espanhol e a palavra de moeda pesos retorna «Diez mil quinientos pesos 75/100»
- A linha vai para o modelo de fatura em espanhol