{"id":252,"date":"2024-11-15T10:21:56","date_gmt":"2024-11-15T13:21:56","guid":{"rendered":"https:\/\/info.ultradesk.com.br\/?page_id=252"},"modified":"2025-10-16T16:31:52","modified_gmt":"2025-10-16T19:31:52","slug":"importacao-de-dados","status":"publish","type":"page","link":"https:\/\/info.ultradesk.com.br\/?page_id=252","title":{"rendered":"Importa\u00e7\u00e3o de Dados"},"content":{"rendered":"\n<p>A importa\u00e7\u00e3o de dados permite a inclus\u00e3o\/altera\u00e7\u00e3o de registros atrav\u00e9s do upload de uma planilha no formato XLSX contendo os registros dentro de um formato espec\u00edfico.<\/p>\n\n\n\n<p>Cada envio (upload) passa pelas seguintes fases&#8230;:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Enviado<\/strong>: o arquivo est\u00e1 no servidor e ser\u00e1 processado na sequencia<\/li>\n\n\n\n<li><strong>Processando<\/strong>: o arquivo est\u00e1 sendo processado pela rotina de importa\u00e7\u00e3o<\/li>\n<\/ul>\n\n\n\n<p>&#8230;e conclui em uma das seguintes posi\u00e7\u00f5es:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Aceito<\/strong>: todo conte\u00fado do envio foi importado<\/li>\n\n\n\n<li><strong>Parcialmente aceito<\/strong>: parte do conte\u00fado foi importado<\/li>\n\n\n\n<li><strong>Recusado<\/strong>: todo conte\u00fado foi recusado<\/li>\n<\/ul>\n\n\n\n<p>A fase\/posi\u00e7\u00e3o \u00e9 exibida ao lado no nome do arquivo. Quando a importa\u00e7\u00e3o \u00e9 recusada ou parcialmente aceita, um relat\u00f3rio \u00e9 disponibilizado com as mensagens de erro para avalia\u00e7\u00e3o. \u00c9 aconselh\u00e1vel criar uma nova planilha somente com as linhas corrigidas para ganhar tempo no processamento durante o pr\u00f3ximo envio.<\/p>\n\n\n\n<p>O arquivo a ser enviado deve cumprir com os seguintes requisitos:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>o nome do arquivo n\u00e3o deve conter caracteres especiais ou espa\u00e7os<\/li>\n\n\n\n<li>apenas uma planilha por arquivo com o nome de <em>Planilha1<\/em> (primeira guia do rodap\u00e9)<\/li>\n\n\n\n<li>a quantidade de colunas deve seguir o modelo do destino<\/li>\n\n\n\n<li>somente as primeiras <em>800<\/em> linhas da planilha ser\u00e3o processadas<\/li>\n\n\n\n<li>n\u00e3o devem haver linhas em branco antes do final do conte\u00fado<\/li>\n<\/ul>\n\n\n\n<p>Conte\u00fados das colunas que excederem o tamanho especificado ser\u00e3o truncados. O processo aceita registros v\u00e1lidos e informa as inconsist\u00eancias dos registros recusados para o usu\u00e1rio que fez o envio.<\/p>\n\n\n\n<p>O destino indica para qual tabela do sistema esses dados ser\u00e3o enviados e informa o sistema qual modelo seguir. Veja abaixo os modelos de planilha de acordo com o destino:<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Pessoas<\/h3>\n\n\n\n<p>O cadastro de clientes, fornecedores, transportadoras, vendedores, t\u00e9cnicos, compradores e colaboradores \u00e9 englobado no termo &#8220;Pessoas&#8221;.<\/p>\n\n\n\n<p>A planilha modelo de Pessoas pode ser baixada <a href=\"https:\/\/info.ultradesk.com.br\/wp-content\/uploads\/2025\/03\/ultraDESK-Modelo-Importacao-Pessoas-v01.xlsx\" data-type=\"attachment\" data-id=\"288\">aqui<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Coluna<\/strong><\/th><th><strong>T\u00edtulo<\/strong><\/th><th><strong>Tipo<\/strong><\/th><th><strong>Tamanho<\/strong><\/th><th><strong>Conte\u00fado (exemplo)<\/strong><\/th><\/tr><\/thead><tbody><tr><td>A<\/td><td>cnpj *<\/td><td>Texto<\/td><td>18<\/td><td>12.345.678\/0001-90<\/td><\/tr><tr><td>B<\/td><td>cpf *<\/td><td>Texto<\/td><td>14<\/td><td>456.456.456-78<\/td><\/tr><tr><td>C<\/td><td>razao_social *<\/td><td>Texto<\/td><td>60<\/td><td>R36 Software Ltda.<\/td><\/tr><tr><td>D<\/td><td>nome_fantasia<\/td><td>Texto<\/td><td>60<\/td><td>R36<\/td><\/tr><tr><td>E<\/td><td>cep *<\/td><td>Texto<\/td><td>9<\/td><td>12345-678<\/td><\/tr><tr><td>F<\/td><td>numero<\/td><td>N\u00famero<\/td><td><\/td><td>123<\/td><\/tr><tr><td>G<\/td><td>complemento<\/td><td>Texto<\/td><td>40<\/td><td>CJ 64<\/td><\/tr><tr><td>H<\/td><td>telefone<\/td><td>Texto<\/td><td>20<\/td><td>+55 11 1234-5678<\/td><\/tr><tr><td>I<\/td><td>celular<\/td><td>Texto<\/td><td>20<\/td><td>+55 11 9 1234-5678<\/td><\/tr><tr><td>J<\/td><td>email<\/td><td>Texto<\/td><td>80<\/td><td>destinatario@servidor.com<\/td><\/tr><tr><td>K<\/td><td>cliente *<\/td><td>Texto<\/td><td>1<\/td><td>S<\/td><\/tr><tr><td>L<\/td><td>fornecedor *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>M<\/td><td>transportador *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>N<\/td><td>vendedor *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>O<\/td><td>tecnico *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>P<\/td><td>comprador *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>Q<\/td><td>colaborador *<\/td><td>Texto<\/td><td>1<\/td><td>N<\/td><\/tr><tr><td>R<\/td><td>observacoes<\/td><td>Texto<\/td><td>2048<\/td><td><\/td><\/tr><tr><td>S<\/td><td>inscricao_estadual<\/td><td>Texto<\/td><td>20<\/td><td>123.123.123.123 (ou RG: 112.335.434-9)<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">* campos requeridos<\/figcaption><\/figure>\n\n\n\n<p>Em especial, a carga para o cadastro de pessoas consome um tempo maior devido \u00e0 consulta dos CEPs para obter o logradouro, munic\u00edpio e estado do registro. Esse tempo \u00e9 de 6 segundos por registro.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Lan\u00e7amentos<\/h3>\n\n\n\n<p>Lan\u00e7amentos \u00e9 um termo gen\u00e9rico usado para englobar tanto os pagamentos como os recebimentos.<\/p>\n\n\n\n<p>A planilha modelo de Lan\u00e7amentos pode ser baixada <a href=\"https:\/\/info.ultradesk.com.br\/wp-content\/uploads\/2025\/03\/ultraDESK-Modelo-Importacao-Lancamentos-v01.xlsx\" data-type=\"attachment\" data-id=\"288\">aqui<\/a>.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><th><strong>Coluna<\/strong><\/th><th><strong>T\u00edtulo<\/strong><\/th><th><strong>Tipo<\/strong><\/th><th><strong>Tamanho<\/strong><\/th><th><strong>Conte\u00fado (exemplo)<\/strong><\/th><\/tr><\/thead><tbody><tr><td>A<\/td><td>tipo *<\/td><td>Texto<\/td><td>1<\/td><td>P<\/td><\/tr><tr><td>B<\/td><td>unidade_neg *<\/td><td>Texto<\/td><td>1<\/td><td>B<\/td><\/tr><tr><td>C<\/td><td>cnpj_cpf *<\/td><td>Texto<\/td><td>20<\/td><td>12.345.678\/0001-09<\/td><\/tr><tr><td>D<\/td><td>conta *<\/td><td>Texto<\/td><td>40<\/td><td>300789<\/td><\/tr><tr><td>E<\/td><td>centro *<\/td><td>Texto<\/td><td>40<\/td><td>ADM<\/td><\/tr><tr><td>F<\/td><td>carteira *<\/td><td>Texto<\/td><td>40<\/td><td>0089<\/td><\/tr><tr><td>G<\/td><td>documento *<\/td><td>Texto<\/td><td>40<\/td><td>BL-123123<\/td><\/tr><tr><td>H<\/td><td>parcela_atual *<\/td><td>N\u00famero<\/td><td>999<\/td><td>1<\/td><\/tr><tr><td>I<\/td><td>parcela_final *<\/td><td>N\u00famero<\/td><td>999<\/td><td>10<\/td><\/tr><tr><td>J<\/td><td>valor_original *<\/td><td>Moeda<\/td><td>9999999999<\/td><td>123,56<\/td><\/tr><tr><td>K<\/td><td>emissao *<\/td><td>Data (AAAA-MM-DD)<\/td><td>10<\/td><td>2025-03-05<\/td><\/tr><tr><td>L<\/td><td>vencimento *<\/td><td>Data (AAAA-MM-DD)<\/td><td>10<\/td><td>2025-04-05<\/td><\/tr><tr><td>M<\/td><td>quitacao<\/td><td>Data (AAAA-MM-DD)<\/td><td>10<\/td><td>2025-05-05<\/td><\/tr><tr><td>N<\/td><td>valor_quitacao<\/td><td>Moeda<\/td><td>9999999999<\/td><td>123,56<\/td><\/tr><tr><td>O<\/td><td>projeto<\/td><td>Texto<\/td><td>40<\/td><td>0029<\/td><\/tr><tr><td>P<\/td><td>observacoes<\/td><td>Texto<\/td><td>2000<\/td><td>pagamento antecipado<\/td><\/tr><\/tbody><\/table><figcaption class=\"wp-element-caption\">* campos requeridos<\/figcaption><\/figure>\n","protected":false},"excerpt":{"rendered":"<p>A importa\u00e7\u00e3o de dados permite a inclus\u00e3o\/altera\u00e7\u00e3o de registros atrav\u00e9s do upload de uma planilha no formato XLSX contendo os registros dentro de um formato espec\u00edfico. Cada envio (upload) passa pelas seguintes fases&#8230;: &#8230;e conclui em uma das seguintes posi\u00e7\u00f5es: A fase\/posi\u00e7\u00e3o \u00e9 exibida ao lado no nome do arquivo. Quando a importa\u00e7\u00e3o \u00e9 recusada [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-252","page","type-page","status-publish","hentry"],"blocksy_meta":[],"_links":{"self":[{"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/pages\/252","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=252"}],"version-history":[{"count":33,"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/pages\/252\/revisions"}],"predecessor-version":[{"id":417,"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=\/wp\/v2\/pages\/252\/revisions\/417"}],"wp:attachment":[{"href":"https:\/\/info.ultradesk.com.br\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=252"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}