Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Aviso

Para que a baixa do NCM criado ocorra no PDV Omni é necessário realizar a abertura de um lote do tipo 8 = NCM

titleexpandtitleDefinição de requisição
Deck of Cards
idversções
Card
labelV3.1 (V2)

Requisição

Section
Column
width50%

Exemplo de body da requisição

[
    {
        "aliquotaEstadual": "string",
        "aliquotaImportada": "string",
        "aliquotaMunicipal": "string",
        "aliquotaNacional": "string",
        "chave": "string",
        "codigoCest": "string",
        "codigoExcecao": "string",
        "codigoNcm": "string",
        "fonte": "string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "situacao": 0
    }
]

Column
width50%

Definições dos campos do body

Campo

Tipo

Descrição

Obrigatório

Observações

codigoNcm

string

Código NCM

Sim

Tamanho: 8 caracteres

codigoExcecaostringCódigo de exceção

Não

Tamanho máximo: 3 caracteres

aliquotaNacionalstring

Aliquota nacional

Não

aliquotaImportada

stringAliquota importadaNão

aliquotaEstadual

stringAliquota EstadualNão

aliquotaMunicipal

stringAliquota MunicipalNão

chave

stringChave NCM

Não

Tamanho máximo: 128 caracteres

fonte

stringFonte NCM

Não

Tamanho máximo: 128 caracteres

situacao

intSítuação do NCMSim0 - inativo, 1 - ativo

codigoCest

stringCódigo cest

Não

Tamanho: 7 caracteres

idInquilino

stringIdentificador do inquilinoSim

idRetaguarda

stringIdentificador do NCM na retaguardaSimTamanho máximo: 100 caracteres

idProprietario

string

Identificador do proprietário

Sim

loteOrigem

stringIdentificação do lote em que os dados serão enviadosSim

Retorno

Deck of Cards
idretornos
Card
label200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Card
label400 - Bad Request
Column
width50%

Exemplo de body de retorno

{
    "code": "string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "guid": "string",
            "code": "string",
            "message": "string",
            "detailedMessage": "string"
        }
    ]
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro
Card
labelV3.2
Informações

Este endpoint ainda está em processo de manutenção, as informações estão disponibilizadas apenas para consulta, não sendo possível realizar a requisição.

Requisição

Section
Column
width50%
Expandir

Exemplo de body da requisição

[
    {
        "aliquotaEstadual": 0.0,
        "aliquotaImportada": 0.0,
        "aliquotaMunicipal": 0.0,
        "aliquotaNacional": 0.0,
        "chave": "string",
        "codigoCest": "string",
        "codigoExcecao": "string",
        "codigoNcm": "string",
        "fonte": "string",
        "idInquilino": "string",
        "idProprietario": "string",
        "idRetaguarda": "string",
        "loteOrigem": "string",
        "situacao": 0
    }
]

Column
width
50%

Definições dos campos

do body

Campo

Tipo

Descrição

Obrigatório

Observações

Obrigatório

codigoNcmstringCódigo do NCM com 8 dígitos.

Sim

Tamanho: 8 caracteres

Sim

codigoExcecaostringCódigo de exceção do NCM com até 3 dígitos

Não

Tamanho máximo: 3 caracteres

Não

aliquotaNacionalnumérico

Alíquota nacional média para o código de NCM na tabela IBPT do estado.

Não

aliquotaImportada

numéricoAlíquota importada média para o código de NCM na tabela IBPT do estado. Não

aliquotaEstadual

numéricoAlíquota estadual média para o código de NCM na tabela IBPT do estado. Não

aliquotaMunicipal

numéricoAlíquota municipal média para o código de NCM na tabela IBPT do estado. Não

chave

stringChave contida na tabela IBPT do estado

Não

Tamanho máximo: 128 caracteres

Não

fonte

stringFonte de onde foi retirada os valores de alíquota nacional, importada estadual e municipal.

Não

Tamanho máximo: 128 caracteres

Não

situacao

intSítuação do NCM Sim0 - inativo, 1 - ativo
Sim

codigoCest

stringA relação entre o NCM e o CEST ocorre pois o CEST utiliza o NCM como base para a sua classificação. Para o PDV o CEST pode estar vinculado ao produto e ao NCM. O CEST identificado no produto terá prioridade sobre ao identificado no NCM.

Não

Tamanho máximo: 20 caracteres

Não

idInquilino

stringIdentificador do inquilinoSim

idRetaguarda

stringIdentificador do NCM na retaguardaSimTamanho máximo: 100 caracteres
Sim

idProprietario

string

Identificador do proprietário

Sim

loteOrigem

stringIdentificação do lote em que os dados serão enviadosSim
expand

Retornos

Deck of Cards
titleDefinição dos campos de retorno
titleexpand400 - Bad Request
idretornos
Card
label
Expandir
200 - Ok
Column
width50%

Exemplo de body de retorno

{
    "success": true,
    "message": "Requisição inserida com sucesso!",
    "data": null,
    "errors": null,
    "totalTime": 0,
    "numberOfRecords": 0
}

Column
width50%

Definições dos campos do retorno

Campo

Tipo

Descrição

SuccessboolIndica se a criação do compartilhamento foi feita com sucesso
MessagestringCaso ocorra erros durante a criação do compartilhamento eles serão enviados nesse campo
DataobjetoObjeto compartilhamento criado
ErrorsListaListas com os erros encontrados no processo
TotalTimeinttempo da requisição
NumberOfRecordsintnúmero de dados inseridos
Body
Card
label400 - Bad Request
Column
width50%

Exemplo de body

Expandir
title

de retorno

{
    "

success

code":

true

"string",
    "message": "string",
    "detailedMessage": "string",
    "helpUrl": "string",
    "details": [
        {
            "

data

guid":

null

"string",
            "

errors

code":

null

"string",
            "

totalTime

message":

0

"string",
            "

numberOfRecords

detailedMessage":

0

"string"
        }
    ]
}

Column
width
title
50%

Definições dos campos do retorno

Campo

Tipo

Descrição

codestringCódigo de erro
messagestringMensagem do erro
detailedMessagestringDetalhamento do erro
helpUrlstringurl de ajuda
TotalTimestringTempo total de busca
detailslista de objetoLista de objeto de erros
details.guidstringIdentificador do erro
details.codestringCódigo do erro
details.messagestringMensagem do erro 
details.detailedMessagestringDetalhamento do erro