Árvore de páginas

Versões comparadas

Chave

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

...

Exemplo de Utilização


Endpoint:Ambiente Stage: https://devstg.motorfiscal.raas.varejo.totvs.com.br/starting/api/v1/cteoperacao
Método:POST
Descrição:Utilize este recurso para inserir um novo registro
Modelo JSON (envio):

{
    "naturezaOperacao": "SUBSTITUICAO",
    "tipoAcao": "EMISSAO",
    "emitente": "EMIT001",
    "indTomador": "REMETENTE",
    "remetente": "ATOR007",
    "destinatario": "ATOR008",
    "operacao": "TRANSPORTE",
    "modal": "RODOVIARIO",
    "tipoServico": "NORMAL",
    "tipoCte": "SUBSTITUICAO",
    "chaveCTeVinc": "35221153113791000122570350000002801546665335",
    "chaveCTeAnul": "35221153113791000122570230000002701952134225",
    "outrasCaracteristicas": "amarelo",
    "urlRetorno": "https://teste.free.beeceptor.com",
    "territorioOrigem": {
        "pais": "Brasil",
        "uf": "SP",
        "cidade": "Sorocaba"
    },
    "territorioDestino": {
        "pais": "Brasil",
        "uf": "SC",
        "cidade": "Joinville"
    },
    "produtos": [
        {
            "valor": 10,
            "quantidade": 2,
            "codigo": "002"
        }
    ],
    "componentesFretes": [
        {
            "codigo": "CF001",
            "nome": "seguro",
            "valor": 1.0
        },
        {
            "codigo":"CF002",
            "nome": "pedágio",
            "valor": 1.0
        }
    ],
    "infCTeNorm": {
        "infCteSub": {
            "indAlteraToma": "1",
            "chCte": "41240512345678912345570240002416531523914612"
        },
        "infCarga": {
            "vCarga": 10475.10,
            "proPred": "MERCADORIAS KLABIN APARAS",
            "xOutCat": "Fardos",
            "vCargaAverb": 10475.10,
            "infQ": [
                {
                    "cUnid": "01",
                    "tpMed": "PESO REAL",
                    "qCarga": 29860.0000
                },
                {
                    "cUnid": "01",
                    "tpMed": "QUANTIDADE",
                    "qCarga": 30.0000
                },
                {
                    "cUnid": "00",
                    "tpMed": "PESO COBRADO",
                    "qCarga": 29860.0000
                },
                {
                    "cUnid": "03",
                    "tpMed": "CUBAGEM (M3)",
                    "qCarga": 0.0000
                }
            ]
        },
        "infDoc": {
            "infNFe": [
                {
                    "chave": "41220689637490013395550010059303221522453794"
                }
            ]
        },
        "infModal": {
            "rodo": {
                "RNTRC": "00070953"
            }
        }
    },

    

    "observacoesGerais":

 

"

OBS GERAL

OBS GERAL",

    

    "observacoesContribuinte":

 

[

        

        "observacoesContribuinte1","observacoesContribuinte2"

    

    ],

    

    "observacoesFisco":

 

[

        

        "observacoesFisco1","observacoesFisco2"

    

    ]

}

Status de retorno:
    • 200 - OK
  • 400 - Bad Request (Um ou mais campos estão inválidos. Faça o preenchimento correto e tente novamente)
  • 401 - Unauthorized (Falha na autenticação)
  • 500 - Internal Error (Falha de comunicação com a fila: fiscal-motor-starting-calculating-topic ou Dados mínimos precisam ser preenchidos)
Exemplo de Json assíncrono Emissão (retorno enviado para o link informado no atributo urlRetorno):  {
    "tipo""EMISSAO",
    "retornoEmissao ":
    {
        "Aprovado"true,
        "Situacao""Autorizado",
        "cStat""100",
        "Descricao""Autorizado o uso do CT-e",
        "chaveacesso""35221153113791000122570220022986891339483933"
    },
    "tributos": [
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "cst""00",
            "vbc"153.41,
            "picms"12.0,
            "predbc"0.0,
            "vicms"18.41
        }
    ],
    "totais": {
        "vprest"153.41,
        "vrec"153.41,
        "vtotTrib"18.41
    },
    "componentes": [
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "tipo""ICMS",
            "codigo""EMBALAGEM",
            "descricao""EMBALAGEM",
            "cst""00",
            "vbc"5.68,
            "picms"12.0,
            "vicms"0.68
        },
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "tipo""ICMS",
            "codigo""SEGURO",
            "descricao""SEGURO",
            "cst""00",
            "vbc"147.73,
            "picms"12.0,
            "vicms"17.73
        }
    ]
}
Exemplo de Json assíncrono Simulação (retorno enviado para o link informado no atributo urlRetorno):{
    "tipo""SIMULACAO",
    "tributos": [
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "cst""00",
            "vbc"153.41,
            "picms"12.0,
            "predbc"0.0,
            "vicms"18.41
        }
    ],
    "totais": {
        "vprest"153.41,
        "vrec"153.41,
        "vtotTrib"18.41
    },
    "componentes": [
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "tipo""ICMS",
            "codigo""EMBALAGEM",
            "descricao""EMBALAGEM",
            "cst""00",
            "vbc"5.68,
            "picms"12.0,
            "vicms"0.68
        },
        {
            "nome""ICMS_TRANSP_0000_S_PED",
            "tipo""ICMS",
            "codigo""SEGURO",
            "descricao""SEGURO",
            "cst""00",
            "vbc"147.73,
            "picms"12.0,
            "vicms"17.73
        }
    ]
}

...