Histórico da Página

...

ÍNDICE

1. Visão GeralVisión general
2. Métodos 
   • INSERT @Post
   • REVERSAL @Post
   • DELETE @Post
3. Tabelas Tablas utilizadas
   
   
   

01. 

...

VISIÓN GENERAL

...

Modelo de dados a ser seguido para consumo da API de lançamentos contábeis.

Esta documentación tiene como propósito mostrar el modelo de datos que se utilizará para el consumo de la API de asientos contables.

02. Métodos 

Header

OBS: Header deve ser enviado para todos os métodos

...

El header debe enviarse a todos los métodos

• INSERT @Post (Inserção Inclusión de Lançamento Contábilasiento contable)

  Âncora
  insert insert

EndPoint: Caminho do serviço Camino del servicio REST Protheus + /api/ctb/accountingentry/insert Ex.: http://localhost:9090/api/ctb/accountingentry/insert

Body

Deverá ser enviado no Debe enviarse en formato Json de acordo com modelo a seguir, de acuerdo con el siguiente modelo

Portada de loteCapa do Lote

Itens do LoteÍtems de lote

OBS.:

*Para A cada capa portada de lote deve ser enviado 1 ou mais itensdebe enviarse 1 o más ítems.

**Número de documento será gerado automaticamente com o próximo disponível para a chave: Datase generará automáticamente con el próximo disponible para la clave: Fecha, Lote, Sublote.

***Número de linhas será gerado automaticamente líneas se generará automáticamente para cada item ítem enviado.

Exemplo Ejemplo de Envioenvío

{ 
    "CT2_DATA":"01/09/2023" ,
    "CT2_LOTE":  "008960",
    "CT2_SBLOTE":  "001",
    "ITENS":[{
        "CT2_MOEDLC":  "01",
        "CT2_DC" :  "3",
        "CT2_CREDIT":  "CTBXATUC",
        "CT2_DEBITO":  "CTBXATUD",
        "CT2_VALOR":  1500.60 ,
        "CT2_HIST": "PARTIDA DOBRADADOBLE ",
    	},
		{
		"CT2_MOEDLC":  "01",
        "CT2_DC" :  "2",
        "CT2_CREDIT":  "CTBXATUC",
        "CT2_VALOR":  1600 ,
        "CT2_HIST": "PARTIDA DOBRADADOBLE ",
		}]
}

Exemplo Ejemplo de Respostarespuesta

{
    "GrupoEmpresa": "T1",  		// grupoGrupo de empresa noen el qualcual ose lançamentoincluyó foiel inseridoasiento.
    "CT2_FILIAL": "D MG 01 ", 	// FilialSucursal en nola qualcual ose lançamentoincluyó foiel inseridoasiento. 
    "CT2_DOC": "000003", 		// Número de documento geradogenerado. 
    "error": ""  				// ErroEl seráerror retornadose emdevolverá vaziovacío casosi ala inclusãoinclusión ocorraocurriera comcon sucessoéxito, emen caso de erroerror seráse retornadodevolverá ala descriçãodescripción dodel erroerror.
}

• REVERSAL @Post (Estorno Reversión de Lançamento Contábilasiento contable)

  Âncora
  reversal reversal

EndPoint: Caminho do serviço Camino del servicio REST Protheus + /api/ctb/accountingentry/reversal Ex.: http://localhost:9090/api/ctb/accountingentry/reversal

Body

Deverá ser enviado no Debe enviarse en formato Json de acordo com modelo a seguir, de acuerdo con el siguiente modelo

OBS.: *Número de documento será gerado automaticamente com o próximo disponível para a chave: Datase generará automáticamente con el próximo disponible para la clave: Fecha, Lote, Sublote.

Exemplo Ejemplo de Envioenvío

{ 
    "CT2_DATA": "01/09/2023" ,
    "CT2_LOTE":  "THIAGO",
    "CT2_SBLOTE":  "001",
    "CT2_DOC" :  "000003",
	"CT2_LOTEST":"EST001",
	"CT2_SBLOTEST":"001"
}

Exemplo Ejemplo de Respostarespuesta

{
    "GrupoEmpresa": "T1",  		// grupoGrupo de empresa noen el qualcual ose lançamentoincluyó deel estornoasiento foide inseridoreversión.
    "CT2_FILIAL": "D MG 01 ", 	// Sucursal Filialen nola qualcual ose lançamentoincluyó deel estornoasiento foide inseridoreversión. 
    "CT2_DOC": "000001", 		// Número de documento de estornoreversión geradogenerado. 
    "error": ""  				// ErroEl seráerror retornadose emdevolverá vaziovacío casosi ola estornoreversión ocorraocurriera comcon sucessoéxito, emen caso de erroerror seráse retornadodevolverá ala descriçãodescripción dodel erroerror.
}

• Âncora
  delete delete

  DELETE @Post (Exclusão Borrado de Lançamento Contábilasiento contable)

  EndPoint: Caminho do serviço Camino del servicio REST Protheus + /api/ctb/accountingentry/delete Ex.: http://localhost:9090/api/ctb/accountingentry/delete

  Body

  Deverá ser enviado no Debe enviarse en formato Json de acordo com modelo a seguir, de acuerdo con el siguiente modelo

  ObrigatórioObservação do Lote Caractere do Lote do lançamento a ser excluídoCaractere do SubLote do lançamento a ser excluído do DocumentoCaractere do Documento do lançamento a ser excluído

  Campo	Descrição Descripción	Tipo	Obligatorio	Observación
  CT2_DATA	Data Lançamento Fecha asiento	Caractere Carácter	X	Fecha del asiento que se borrará. Se envía en formato carácter ddmmaaaa ej Data do lançamento que será excluído. Enviada em formato caractere ddmmaaaa ex: "29/08/2022"
  CT2_LOTE	Número	de lote	Carácter	X	Número	de lote del asiento que se borrará.
  CT2_SBLOTE	Número do SubLote  de sublote	Carácter	X	Número	de sublote del asiento que se borrará.
  CT2_DOC	Número	del documento	Carácter	X	Número	de documento del asiento que se borrará.

  
  

  Exemplo Ejemplo de Envioenvío

  Bloco de código
  language java title Exemplo Ejemplo de Envioenvío
  { "CT2_DATA": "01/09/2023" , "CT2_LOTE": "000001", "CT2_SBLOTE": "001", "CT2_DOC" : "000005" }

  Exemplo Ejemplo de Respostarespuesta

  Bloco de código
  language java title Exemplo Ejemplo de resposta respuesta
  { "GrupoEmpresa": "T1", // grupoGrupo de empresa noen el qualcual ose lançamentoborró foiel excluídoasiento. "CT2_FILIAL": "D MG 01 ", // Sucursal Filialen nola qualcual ose lançamentoborró foiel excluídoasiento. "CT2_DOC": "000005", // Número de documento excluídoborrado. "error": "" // ErroEl seráerror retornadose emdevolverá vaziovacío casosi ael exclusãoborrado ocorraocurriera comcon sucessoéxito, emen caso de erroerror seráse retornadodevolverá ala descriçãodescripción dodel erroerror. }

03.

...

TABLAS UTILIZADAS

• CT2- Lançamentos ContábeisAsientos contables
• CT1- Plano Plan de Contascuentas
• CTT- Centro de Custocosto
• CTH- Classe Clase de Valorvalor
• CTD - Item ContábilÍtem contable