Essa funcionalidade será expedida na versão Totvs 12.1.2603 e também será liberada via console nos patches 12.1.2507.6, 12.1.2503.12 e 12.1.2411.17. |
Este documento tem como objetivo descrever o que poderá ser customizado na tela HTML do programa Evento tributos (html.mcd.eventoTributos).
Aqui será descrito quais componentes e elementos podem ser customizados.
Esse documento somente cita itens de customização que diferem da customização padrão de uma tela HTML utilizando PO-UI, ou seja, somente as especificidades de customização do programa HTML em questão. As customizações nativas dos componentes dinâmicos do PO-UI podem ser verificadas aqui e não serão abordadas nesse documento. |
Segue a lista de APIs e Pontos de UPC responsáveis pelo processamento da interface dinâmica e dos dados do programa.
Para maiores detalhes de como cadastrar uma UPC para essa API podem ser visualizados aqui.
| Manipulação de Objetos da Interface (Metadata) | |||
|---|---|---|---|
| Endpoint | Evento | Entrada | Observação |
| getMetaData | list | Metadados | Estrutura metadados da listagem. |
| getMetaData | new | Metadados | Estrutura metadados da tela de inclusão. |
| getMetaData | edit | Metadados | Estrutura metadados da tela de edição. |
| getMetaData | detail | Metadados | Estrutura metadados da tela de detalhes. |
| getMetaData | copy | Metadados | Estrutura metadados da tela de cópia/duplicação de registro. |
| getMetaData | listItems | Metadados | Estrutura metadados da listagem de itens do evento (quando o evento tem itens). |
| getMetaData | editItems | Metadados | Estrutura metadados da edição do item do evento. |
| Manipulação de Dados | |||
|---|---|---|---|
| Endpoint | Evento | Entrada | Observação |
| findById | findById | Dados do registro | Executado depois de buscar um registro específico. |
| findAll | findAll | Dados dos registros | Executado depois de buscar os registros. |
| create | beforeCreate | Payload | Executado antes de criar um registro. |
| create | afterCreate | Payload | Executado depois da criação de um registro. |
| update | beforeUpdate | Payload | Executado antes da alteração de um registro. |
| update | afterUpdate | Payload | Executado depois da alteração de um registro. |
| delete | beforeDelete | Payload | Executado antes da eliminação de um registro. |
| delete | afterDelete | Payload | Executado depois da eliminação de um registro. |
| deleteList | beforeDeleteList | Payload | Executado antes da eliminação de um lote de registros. |
| deleteList | afterDeleteList | Payload | Executado depois da eliminação de um lote de registros. |
Pode ser implementada uma UPC para captar os eventos de geração de planilha.
Detalhes dos endpoints que permitem customização estão nessa documentação.
É possível retornar o metadata das telas para fazer a analise da estrutura do JSON, executando as requests abaixo (depois de logado no produto Datasul):
| Tipo | Endpoint | Observações |
|---|---|---|
| Listagem | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/?type=list | |
| Inclusão | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/?type=new | |
| Edição | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/<chave-acesso + '|' + cod-evento + '|' + seq-evento>?type=edit | Utiliza a chave de acesso do DF-e, código do evento e sequência do evento como path param. |
| Duplicar/Cópia | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/<chave-acesso + '|' + cod-evento + '|' + seq-evento>?type=copy | Utiliza a chave de acesso do DF-e, código do evento e sequência do evento como path param. |
| Visualização | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/<chave-acesso + '|' + cod-evento + '|' + seq-evento>?type=detail | Utiliza a chave de acesso do DF-e, código do evento e sequência do evento como path param. |
| Listagem de itens do evento | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/<chave-acesso + '|' + cod-evento + '|' + seq-evento + '|' + cod-estabel + '|' + modulo-orig-info>?type=listItems | Utiliza a chave de acesso do DF-e, código do evento, sequência do evento, estabelecimento e módulo origem da informação como path param. |
| Edição de item do evento | https://<servidor>:<porta>/api/cdp/v1/eventotributos/metadata/<chave-acesso + '|' + cod-evento + '|' + seq-evento + '|' + cod-estabel + '|' + modulo-orig-info>?type=editItems | Utiliza a chave de acesso do DF-e, código do evento, sequência do evento, estabelecimento e módulo origem da informação como path param. |
Não há especificidades na listagem dessa tela, está sendo utilizada a combinação do componente dinâmico po-page-dynamic-search com uma po-table.
Na edição há dois formulários dinâmicos (po-dynamic-form), um formulário só visualização (po-dynamic-view) e um array de fields referentes a metadados de listagem de mensagens:
Os arrays podem ser manipulados por uma UPC e retornados para a tela modificando ou adicionando campos.