Emissão

URL

Emissão CT-e: POST https://cte.v2.ns.eti.br/cte/issue
Emissão CT-e: POST https://cte.v2.ns.eti.br/cte/issueos
Emissão CT-e Simplificado: POST https://cte.v2.ns.eti.br/cte/issuesimp

Dados de entrada

Os dados do CT-e para o método de emissão podem ser enviados em JSON, XML ou em TXT.

Envio de dados em formato JSON

Para envio dos dados em JSON do Content-Type da requisição deverá ser definido como application/json.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de CT-e no formato JSON:

Envio de dados em formato XML

Para envio dos dados em XML o Content-Type da requisição deverá ser definido como application/xml e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.

No envio em formato XML o corpo da requisição deverá conter o conteúdo do XML com as informações do CT-e. Esse conteúdo deverá ser gerado a partir do layout do Manual de Orientações do Contribuinte da Sefaz.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de CT-e no formato XML:

Envio de dados em formato TXT

Para envio dos dados em TXT do Content-Type da requisição deverá ser definido como text/plain;charset=utf-8.

No envio em formato TXT o corpo da requisição deverá conter o conteúdo do TXT com as informações do CT-e. Esse conteúdo deverá ser gerado a partir do layout do TXT de emissão do integrador local da News Systems.

Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de CT-e no formato TXT:

Exemplo de requisição

Requisição de emissão de CT-e em JSON

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "X-AUTH-TOKEN":"...",
      "CTe":{...}, 
      "infModal":{...}
     }' \
    https://cte.v2.ns.eti.br/cte/issue

Requisição de emissão de CT-e em TXT

curl -X POST \
    -H "Content-Type: text/plain" \
    -d 'CONHECIMENTO|1| \
        A|3.00|CTe|' \
     https://cte.v2.ns.eti.br/cte/issue

Dados retornados

Exemplos de retorno

Retorno com sucesso

{
  "status": 200,
  "motivo": "CT-e enviado para Sefaz",
  "chCTe": "43151212936129000195570000000009451000009454",
  "nsRec": "7ec60c44-ccf3-47db-bda8-8195e8fe795a"
}

Retorno com erro de dados

{
  "status": -4,
  "motivo": "Modal invalido de acordo com a validacao contra schema",
  erros": [
        "O campo 'dhEmi' foi preenchido incorretamente com o valor '2020-04-10T11:30:04'. Este campo deve ser preenchido com data no seguinte formato: 'AAAA-MM-DDThh:mm:ss TZD (Ex.: 2010-            08-19T13:00:15-03:00)'. (cvc-pattern-valid: Value '2017-11-10T11:30:04' is not facet-valid with respect to pattern '(((20(([02468][048])|([13579][26]))-02-29))|(20[0-9][0-9])-((((0[1-9])|(1[0-2]))-((0[1-9])|(1\\d)|(2[0-8])))|((((0[13578])|(1[02]))-31)|(((0[1,3-9])|(1[0-2]))-(29|30)))))T(20|21|22|23|[0-1]\\d):[0-5]\\d:[0-5]\\d([\\-,\\+](0[0-9]|10|11):00|([\\+](12):00))' for type '#AnonType_dhEmiideinfCteTCTe'.)"
    ]
}

Códigos de retorno